Мой Склад JSON API
Общие Сведения
Аутентификация
Для того чтобы успешно взаимодействовать с JSON API онлайн-сервиса МойСклад необходимо аутентифицироваться
в системе. МойСклад поддерживает аутентификацию по протоколу Basic Auth, при которой вместе с запросом
передаётся заголовок Authorization со значением пары логин:пароль, зашифрованной в вариантом RFC2045-MIME
кодировки Base64. Аутентификация по протоколу Basic Auth с автоматической генерацией соответствующего
заголовка поддерживается во многих HTTP-клиентах, таких как Postman, curl и т.п.
Ограничения
Для JSON API установлены следующие ограничения:
- Не более 100 запросов за 5 секундный период
- Не более 5 параллельных запросов от одного пользователя
- Не более 20 параллельных запросов от аккаунта
- Не более 500 запросов с одного ip-адреса
- Не более 10 Мб данных в одном запросе, отправляемом на сервер
Также накладывается ограничение на максимальное число объектов (позиций, материалов, продуктов), передаваемых в одном массиве в запросе - не более 100 элементов. В случае, если количество элементов коллекции превышает максимально допустимое, произойдёт ошибка со статусом 413. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом, описание которого приведено в конкретной сущности.
Метаданные
В JSON есть несколько видов Метаданных. Один из них - поле meta, которое фигурирует в большинстве JSON представлений объектов, и содержит информацию об объекте или о выдаче, а также может использоваться в качестве ссылки на другой объект. Поле meta представляет собой объект со следующими атрибутами:
- href - Ссылка на объект
- metadataHref - Ссылка на метаданные сущности (Другой вид метаданных. Присутствует не во всех сущностях)
- type - Тип объекта
- mediaType - Тип данных, которые приходят в ответ от сервиса, либо отправляются
в теле запроса. В рамках данного API всегда равен
application/json - uuidHref - Ссылка на объект на UI. Присутствует не во всех сущностях. Может быть использована для получения uuid
Атрибуты расширенного объекта meta
Следующие атрибуты объекта meta появляются, как правило, в методах выдачи списка сущностей/строк отчёта. В них содержится информация о выдаче, пришедшей в ответ. В объектах meta, содержащих данные лишь об одном объекте (например поле meta в объекте context) нижеперечисленные атрибуты не фигурируют.
- size - Размер выданного списка
- limit - Максимальное количество элементов в выданном списке. Максимальное количество элементов в списке равно 1000, для вложенных коллекций - 100.
- offset - Отступ в выданном списке
Метаданные сущности
Другой вид Метаданных. Представляет собой отдельный ресурс, содержащий информацию обо всех объектах сущностей данного типа. Есть не у каждой сущности. Присутствует лишь у тех сущностей, у которых в данной документации описан ресурс "Метаданные <наименование_сущности>". Как правило содержит информацию о вложенных сущностях, коллекциях и дополнительных полях.
JSON API позволяет получить метаданные всех сущностей с помощью метода /entity/metadata. Также можно ограничить
выборку, указав в фильтре type только необходимые сущности.
Пример запроса на получение метаданных с помощью GET:
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/metadata?filter=type=product;type=service;type=demand"
-H "Authorization: Basic <api token>"
Пример тела запроса:
{
"service": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"mediaType": "application/json"
}
},
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"mediaType": "application/json"
}
}
}
Мета коллекций
meta коллекций содержит все те же атрибуты, что и meta сущностей, однако, если в списке появляется больше позиций, чем умещается на одной странице (size > limit) в объект meta добавляются след. поля:
- nextHref - Ссылка на предыдущую страницу сущностей.
- previousHref - Ссылка на следующую страницу сущностей.
meta с такими полями можно встретить при выполнении запросов на получение всех объектов определённого типа на учетной записи (например запрос всех отгрузок), а также при запросе всех позиций отдельного документа.
Обработка ошибок
СТРУКТУРА ОШИБОК
Ошибка в данном API представляет собой массив errors, содержащий объекты error, каждый из которых описывает отдельную ошибку.
СТРУКТУРА ОБЪЕКТА error
- error - Заголовок ошибки
- parameter - Параметр, на котором произошла ошибка
- code - Код ошибки (Если поле ничего не содержит, смотрите HTTP status code)
- error_message - Сообщение, прилагаемое к ошибке.
Возвращаемые HTTP статусы ошибок и их значения:
| HTTP status code | Значение |
|---|---|
| 301 | Запрашиваемый ресурс находится по другому URL. |
| 303 | Запрашиваемый ресурс может быть найден по другому URI и должен быть найден с использоваием GET запроса |
| 400 | Ошибка в структуре JSON передаваемого запроса |
| 401 | Имя и/или пароль пользователя указаны неверно или заблокированы пользователь или аккаунт |
| 403 | У вас нет прав на просмотр данного объекта |
| 404 | Запрошенный ресурс не существует |
| 405 | http-метод указан неверно для запрошенного ресурса |
| 409 | Указанный объект используется и не может быть удалён |
| 410 | Версия API больше не поддерживается |
| 412 | Не указан обязательный параметр строки запроса или поле структуры JSON |
| 413 | Размер запроса или количество элементов запроса превышает лимит (например, количество позиций, передаваемых в массиве positions, превышает 100) |
| 429 | Превышен лимит количества запросов |
| 500 | При обработке запроса возникла непредвиденная ошибка |
| 502 | Сервис временно недоступен |
| 503 | Сервис временно отключен |
| 504 | Превышен таймаут обращения к сервису, повторите попытку позднее |
Также, вместе с телом ответа ошибки, вам могут прийти следующие заголовки (Headers): + X-Lognex-Auth - расширенный код ошибки аутентификации + X-Lognex-Auth-Message - сообщение об ошибке. + X-Lognex-API-Version-Deprecated - дата отключения запрошенной версии API. + Location - URL по которому доступен запрашиваемый ресурс (в случае ответа с кодом 301 или кодом 303)
Вы можете узнать лимит оставшихся запросов с помощью следующих заголовков + X-RateLimit-Limit - количество запросов, которые равномерно можно сделать в течение интервала до появления 429 ошибки + X-Lognex-Retry-TimeInterval - интервал в миллисекундах, в течение которого можно сделать эти запросы + X-RateLimit-Remaining - Число запросов, которые можно отправить до получения 429 ошибки + X-Lognex-Reset - время до сброса ограничения в миллисекундах. Равно нулю, если ограничение не установлено + X-Lognex-Retry-After - время до сброса ограничения в миллисекундах.
Работа с дополнительными полями
Список сущностей, у которых есть доп. поля:
- Договор
- Контрагент
- Юрлицо
- Проект
- Склад
- Сотрудник
- Товар
- Услуга
- Комплект
- Серия
- Все документы:
- Возврат покупателя
- Возврат поставщику
- Входящий платёж
- Заказ покупателя
- Заказ поставщику
- Исходящий платёж
- Оприходование
- Отгрузка
- Перемещение
- Приёмка
- Приходный ордер
- Расходный ордер
- Розничная продажа
- Розничная смена
- Розничный возврат
- Списание
- Инвентаризация
- Счёт покупателю
- Счёт поставщика
- Счёт-фактура выданный
- Счёт-фактура полученный
- Прайс-лист
- Внутренний заказ
- Заказ на производство
- Тех. операция
- Полученный отчёт комиссионера
- Выданный отчёт комиссионера
Дополнительные поля сущности - внутренняя коллекция attributes. Представлена в виде массива объектов с полями:
- meta - Ссылка на метаданные доп. поля.
- id - Id соответствующего доп. поля.
- name - Наименование доп. поля
- value - Значение, указанное в доп. поле.
Посмотреть все созданные в основном интерфейсе доп. поля можно с помощью запроса на получение метаданных Сущности. Ответ - объект, содержащий метаданные об объектах данного типа, и в случае объектов, для которых определены доп. поля - информацию о доп. полях в виде коллекции attributes, объекты которой содержат следующие поля:
- meta - Ссылка на метаданные доп. поля
- id - Id доп. поля
- name - Наименование доп. поля
- type - Тип доп. поля
- required - Флажок о том, является ли доп. поле обязательным
Возможные значения типа доп. поля (поле type) и соответствующие им значения типа в JSON, а также типы атрибута value в JSON объекта доп поля при соответствующем type:
| Тип атрибута | Значение поля type в JSON | Тип поля value в JSON |
|---|---|---|
| Строка | string | string |
| Число целое | long | number |
| Дата | time | string |
| Справочник | {entityType} | object ** |
| Файл | file | string |
| Число дробное | double | number |
| Флажок | boolean | boolean |
| Текст | text | string |
| Ссылка | link | string |
Отдельного упоминания заслуживает тип Атрибута Справочник. Значение type в представлении объекта атрибута будет разным, в зависимости от того, справочник каких сущностей был выбран при создании Атрибута. Ниже представлена таблица, в которой при выбранном типе Атрибута "Справочник" показаны значения поля type в зависимости от выбранного типа сущностей в справочнике.
Если в качестве типа доп. поля выбран пользовательский справочник, то в составе объекта данного доп. поля появится новый атрибут customEntityMeta являющийся ссылкой на метаданные этого справочника. Полный набор атрибутов доп. поля будет выглядеть следующим образом:
- meta - Ссылка на метаданные доп. поля
- customEntityMeta - Ссылка на метаданные пользовательского справочника
- id - ID доп. поля
- name - Наименование доп. поля
- type - Тип доп. поля
- required - Флажок о том, является ли доп. поле обязательным
| Тип сущностей справочника | Значение поля type в JSON (entityType) |
|---|---|
| [Контрагент] | counterparty |
| [Товар] | product |
| [Склад] | store |
| [Проект] | project |
| [Договор] | contract |
| [Сотрудник] | employee |
| Имя_пользовательского справочника | customentity |
При выбранном типе Атрибута "Справочник" атрибут value в его представлении будет объектом со следующими свойствами: + meta - Метаданные, представляющие собой ссылку на сущность из соответствующего справочника + name - Наименование соответствующей сущности
Обнуление доп. поля типа "Справочник" происходит так же, как и при работе с другими доп. полям. В запросе на обновление в коллекции attributes следует указать объект с id данного поля, а в качестве value передать null.
С коллекцией доп. полей можно работать только в контексте отдельной сущности. Доп. поля и их значения можно передать как коллекцию структур {id : uuid, value : ""} в теле запроса как на создание, так и на обновление сущности. Опционально можно передать также значение полей meta и name. В переданном массиве объектов можно указать не все доп. поля - проинициализируются/обновятся только указанные. Если для доп. поля указан id, которого нет в метаданных сущности, то возникнет ошибка.
При обновлении значений доп.полей если в теле запроса на обновление сущности в массиве доп. полей:
- Не указаны id каких-либо доп.полей, которым в данной сущности уже присвоено значение - соответствующие доп. поля обновлены не будут.
- Указаны id, доп. полей, которым в данной сущности уже присвоено значение - соответствующим доп. полям будет присвоено переданное значение.
- Указаны id, доп. полей, которым в данной сущности ещё не присвоено значение - соответствующим доп. полям эти новые значения будут присвоены.
В рамках JSON API нельзя создавать дополнительные поля.
Доп. поля типа файл
Для загрузки значения для доп. поля типа файл нужно в JSON при создании или обновлении для значения поля указать объект следующей структуры:
- filename - Имя файла
Необходимое - content - Байты файла, закодированные в base64
Необходимое
Пример указания значения для доп. поля типа файл есть в секции создания товара
Работа с позициями документов
API сервиса МойСклад позволяет оперировать с такими документами как Отгрузка, Заказ покупателя, Счёт покупателю, Розничная продажа. Перечисленные документы содержат позиции, работать с которыми можно как в составе отдельного документа, так и с помощью специальных ресурсов для управления позициями документа.
Работа с позициями в рамках отдельного документа
При работе с позициями в рамках отдельного документа, их можно передавать как поле positions, представляющее собой массив позиций документа, в составе объекта, использующегося в запросе на изменение или создание документа. В таком случае, массив позиций воспринимается как множество всех позиций документа и полностью заменяет (в случае запроса на обновление) все уже существующие позиции в документе. В случае запроса на обновление, все позиции, которые существовали ранее в документе, но не были переданы в теле запроса на обновление, будут удалены, все существующие позиции, id которых совпал с id передаваемых позиций в теле запроса, будут обновлены, а новые позиции, которых ранее не было среди существующих позиций документа, будут добавлены в список позиций.
Работа с позициями документов с помощью специальных ресурсов
В JSON API предусмотрены специальные ресурсы для управления позициями документов. Эти ресурсы как правило доступны по следующему URI и с помощью них вы сможете удалять позиции из документа, сделав запрос с методом DELETE по URL соответствующего ресурса с указание id позиции:
/{код сущности документа, в составе JSON API}/{id отдельного документа}/positions
Пример URL для запроса на удаление с помощью DELETE:
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/{код сущности документа, в составе JSON API}/{id отдельного документа}/positions/179dd832-960c-11e6-8a84-bae5000000dc
-H "Authorization: Basic <api token>"
При работе со специальными ресурсами можно запрашивать список всех позиций документа, создавать новые позиции, а также обновлять существующие. При создании новых позиций с помощью данных ресурсов, можно обходить ограничение в 100 позиций на документ. Также, используя данный ресурс, можно управлять массовым обновлением позиций. Для изменения сведений по отдельным позициям необходимо использовать ресурсы управления отдельными позициями документа, которые доступны по URI:
/{код сущности документа, в составе JSON API}/{id отдельного документа}/positions/{id отдельной позиции}
Оба способа работы с позициями также описаны в документации по каждому из документов.
Также возможно массовое удаление позиций документа, используя метод POST по URL соответствующего ресурса. В теле запроса необходимо указать массив удаляемых позиций, указав поле meta у каждой из позиций.
Пример URL для запроса на массовое удаление позиций с помощью POST:
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/{код сущности документа, в составе JSON API}/{id отдельного документа}/positions/delete
-H "Authorization: Basic <api token>"
Пример тела запроса:
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/727cf336-0310-11e6-9464-e4de00000013",
"type": "demandposition",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/727cfce0-0310-11e6-9464-e4de00000014",
"type": "demandposition",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/727d057f-0310-11e6-9464-e4de00000015",
"type": "demandposition",
"mediaType": "application/json"
}
}
]
Остатки в позициях документов
Представление остатков в составе позиции
"stock": {
"cost": 5000,
"quantity": 999,
"reserve": 90,
"intransit": 9,
"available": 918
}
При запросе и обновлении документов есть возможность получать остатки позиций этих документов.
Для получения остатков в позициях документа в запросе нужно передать дополнительный параметр fields=stock.
Например,
/customerorder/{id документа}?fields=stock&expand=positions
Остатки можно получить по следующим документам: [Отгрузка, Заказ Покупателя, Розничная продажа, Счет покупателя, Заказ поставщика, Счет поставщика, Приемка, Возврат поставщику, Возврат покупателя, Розничный возврат]
Остатки для документов Отгрузка, Розничная продажа, Приемка, Возврат поставщику, Возврат покупателя, Розничный возврат расчитываются на момент поля moment в данных документах. Для Заказа покупателя, Счета покупателя, Заказа поставщика, Счета поставщика остатки рассчитываются на текущий момент времени.
Получить остатки можно для следующих запросов:
- Получения списка операций
- Получение отдельной операции
- Получение позиций операции
- Получение отдельной позиции операции
- Обновление операции
- Обновление позиции
Для возврата покупателя без основания и розничного возврата без основания поле cost будет отсутствовать в составе stock.
Назначение поля syncId
Сущностям, у которых среди атрибутов присутствует поле syncId, оно необходимо для того, чтобы в случае сбоя
при повторной отправке запроса на создание новой сущности не происходило дублирование объектов. Если в теле запроса
на создание сущности указать сгенерированный на клиенте syncId, то при повторной отправке этого же запроса (с тем же syncId) вместо создания
сущности с идентичными полями в ответ придёт ранее созданная сущность.
Сущности, поддерживающие поле syncId, можно удалить, используя url типа /entity/{type}/syncid/{id}.
Создание и обновление объекта
При создании объекта достаточно заполнить только поля, помеченные Необходимое. Данные поля используются только при создании, при обновлении они не требуются.
Поля, помеченные Только для чтения, игнорируются при создании/обновлении объекта.
Создание и обновление нескольких объектов
При использовании метода POST вы можете указать в теле запроса вместо одной -
массив сущностей. Для этого, вам нужно передать массив (начать тело запроса с [ и закончить ]), который будет содержать JSON представления
объектов, которые вы хотите создать или обновить. Обновляемые сущности должны содержать идентификатор в виде метаданных.
Если при обновлении сущность не найдена, она будет создана.
Лимит на создание и обновление объектов списком - 100
Поддержка null
В рамках JSON API можно удалить значение из поля типа объект (если это поле не является обязательным, или же если данное поле в
основном интерфейсе может содержать пустое значение). Например: поле Договор(contract) в любом из документов. Сделать это можно передав в
запросе на обновление сущносте в данное поле null. Например: { "contract": null }.
Удаление валюты из документов ({rate: null}) равносильно изменению валюты документа на валюту по умолчанию. В результате все
цены и суммы будут пересчитаны. Накладные расходы также будут пересчитаны, если они не были указаны явно.
Пустые поля
Если какое-то из полей сущности не было заполнено и, при этом оно не является обязательным, оно не будет выдано в JSON представлении этой сущности.
Формат даты и времени
В JSON API поля типа дата-время (момент времени) - это строка в формате:
+ Без миллисекунд: ГГГГ-ММ-ДД ЧЧ:мм:сс
+ С миллисекундами: ГГГГ-ММ-ДД ЧЧ:мм:сс.ммм
Для получения полей типа дата-время с миллисекундами в формате: ГГГГ-ММ-ДД ЧЧ:ММ:СС.ммм нужно добавить специальный заголовок к запросу:
X-Lognex-Format-Millisecond со значением true.
В запросах на создание/обновление сущностей, а также в параметрах фильтрации нужно указывать moment именно в этом формате.
Следующие поля устанавливаются и выводятся в JSON API с точностью до минут, а именно со значением секунд и миллисекунд равным 00:
- incomingDate
- commisionPeriodStart
- commisionPeriodEnd
- certificateDate
- moment
- deliveryPlannedMoment
- paymentPlannedMoment
- firstDemandDate
- lastDemandDate
- дополнительное поле с типом Дата
Сортировка объектов
Для сортировки списка объектов можно использовать url параметр order.
Значение этого параметра - urlencoded строка с условиями сортировки, перечисленными через ;. (Все примеры ниже указаны без urlencoded для лучшей читаемости)
Каждое условие сортировки- это сочетание названия поля, запятой (опционально, если указывается направление сортировки), направления сортировки (опционально; может принимать значения asc и desc. Значение по умолчанию - asc).
Сортировка поддерживается для следующих типов полей: числовой, строковый, дата-время, логический и uuid.
Примеры запросов с сортировкой:
- https://online.moysklad.ru/api/remap/1.2/entity/supply?order=name
- https://online.moysklad.ru/api/remap/1.2/entity/product?order=code,desc
- https://online.moysklad.ru/api/remap/1.2/entity/product?order=name;code,desc
- https://online.moysklad.ru/api/remap/1.2/entity/product?order=name,desc;code,asc
Фильтрация выборки с помощью параметра filter
Для фильтрации выборки по нескольким полям можно использовать url параметр filter.
Значение этого параметра - urlencoded строка с поисковыми условиями, перечисленными через ;. (Все примеры ниже указаны без urlencoded для лучшей читаемости)
Каждое поисковое условие - это сочетание названия поля, оператора и константы.
Фильтровать можно по всем полям, значения которых являются примитивными типами. Т.е. нельзя фильтровать поля-объекты и поля-массивы,
все остальные поля могут быть использованы в параметре filter.
- Допустимые операторы:
['=', '>', '<', '>=', '<=', '!=', '~', '~=', '=~']
Если в поисковом запросе несколько раз встречается условие типа "равенство" = применённое к одному и тому же полю,
то такое условие интерпретируется как совокупность условий, разделённых логическим оператором ИЛИ.
+ Например условие filter=sum=100;sum=150 будет интерпретировано как sum=100 ИЛИ sum=150
или же sum in (100, 150)
Если же встречается несколько условий вида "не равно" !=, наложенных на одну и ту же переменную, то они интерпретируются как совокупность
условий разделённых логическим оператором И.
+ Например условие filter=name!=0001;name!=0002 будет эквивалентно следующим (взаимно эквивалентным) условиям :
name != 0001 И name != 0002 или name not in (0001, 0002)
Если на одно из полей наложено ограничение типа "равенство", а затем на него накладывается ограничение типа неравенство - в таком случае произойдёт ошибка.
+ Например условие filter=sum=100;sum>99 вызовет ошибку.
Допускается использование одновременно нескольких одинаковых операторов сравнения ['>', '<', '>=', '<='] для одного поля. При этом будет использовано лишь первое значение.
+ Например условие filter=sum>99;sum>100 будет аналогично условию filter=sum>99.
В будущих версиях такое условие будет вызывать ошибку.
Фильтры, применённые к разным полям объединяются через логическое И, т.е. в запросе вида:
+ filter=sum=100;moment>2016-10-11 12:00:00 выборка будет отфильтрована и по сумме и по дате.
Проверка на пустое значение
Если в строке фильтрации указать конструкцию вида: <имя_поля>=; то в выборку попадут только объекты, где
данное поле равно null (т.е. отсутствует значение), а если тип поля - строковое, то будет также выполнена проверка на пустую строку, т.е. поле=''.
Конструкция <имя_поля>!=; выполнит проверку на присутствие значения. С помощью данной конструкции можно проверить наличие значения в ссылочном поле.
Фильтрация документов
Для фильтрации выборки документов следует использовать параметр isDeleted. Может принимать значения true и false.
+ При указании значения true вернутся все документы данного типа, находящиеся в корзине.
+ При указании значения false вернутся только неудалённые документы.
+ Можно вывести все документы: и удалённые, и нет, указав в запросе оба значения данного параметра: filter=isDeleted=true;isDeleted=false.
Фильтрация сущностей
Для фильтрации выборки сущностей следует использовать параметр archived. Данный параметр принимает значения true и false.
+ При указании значения true вернутся все сущности данного типа, находящиеся в архиве.
+ При указании значения false вернутся только не архивные сущности.
+ Можно вывести все сущности: и архивные, и нет, указав в запросе оба значения данного параметра: filter=archived=true;archived=false.
Фильтровать по параметру archived можно только те сущности, у которых данный параметр присутствует в списке полей.
Фильтрация ссылочных полей
С помощью filter можно фильтровать ссылочные поля. Если в сущности присутствует ссылочное поле в виде метаданных, можно использовать следующую конструкцию для того чтобы отфильтровать по этому полю выборку:
filter=<имя_поля>=<ссылка>
Пример ссылки:
http://online.moysklad.ru/api/remap/1.2/entity/<type>/<id>
Вот несколько примеров:
filter=agent=http://online.moysklad.ru/api/remap/1.2/entity/counterparty/<id>filter=ownAgent=http://online.moysklad.ru/api/remap/1.2/entity/organization/<id>
Ссылочные поля, доступные для фильтрации: + agent + ownAgent + owner + group + parent + contract + project + organization + store + agentStore + supplier
Для розничных операций ("Розничная смена", "Розничная продажа", "Розничный возврат", "Внесение денег", "Выплата денег") также доступна фильтрация по: + retailstore
Примеры запросов для фильтрации :
+ https://online.moysklad.ru/api/remap/1.2/entity/demand?filter=moment>2016-10-11 12:00:00;moment<2016-10-11 13:00:00;sum=100;name=0010;name=0011
+ https://online.moysklad.ru/api/remap/1.2/entity/counterparty?filter=name=Иван;phone=89269269222;email=vanyan@mail.krut
Фильтрация по полям типа ID
С помощью filter можно фильтровать поля типа ID.
filter=<имя_поля>=<ID>
Пример ID:
94975104-3cad-11e8-1e44-bd4d00000084
Например:
filter=productid=94975104-3cad-11e8-1e44-bd4d00000084
Фильтрация по дополнительным полям
С помощью filter можно фильтровать по дополнительным полям. Список дополнительных полей сущности указан в ее метаданных
https://online.moysklad.ru/api/remap/1.2/entity/product/metadata
Можно использовать следующую конструкцию для того чтобы отфильтровать по дополнительному полю выборку:
filter=<ссылка на доп.поле>=<значение>
для доп.полей типа справочник:
filter=<ссылка на доп.поле>=<ссылка на сущность>
Пример ссылки на доп.поле
http://online.moysklad.ru/api/remap/1.2/entity/<type>/metadata/attributes/<id>
Пример ссылки на сущность:
http://online.moysklad.ru/api/remap/1.2/entity/<type>/<id>
для доп.полей типа пользовательский справочник
http://online.moysklad.ru/api/remap/1.2/entity/customentity/<customentity_id>/<id>
Примеры фильтра:
filter=https://online.moysklad.ru/api/remap/1.2/entity/<type>/metadata/attributes/<id> =42filter=https://online.moysklad.ru/api/remap/1.2/entity/<type>/metadata/attributes/<id> =http://online.moysklad.ru/api/remap/1.2/entity/<type>/<id>
Фильтрация по сущностям, на которые нет права просмотра
При фильтрации по сущности, на которую у текущего пользователя нет прав на просмотр в ответе придёт пустой список. Например, при фильтрации задач (task) по автору (author), который является сотрудником, которого не может просматривать текущий пользователь, в ответ вернётся пустой список задач.
Контекстный поиск
В JSON API можно осуществлять контекстный поиск среди списка сущностей определённого типа по их строковым полям. Для этого
используется URI параметр фильтрации search
+ search
Параметр фильтрации, с помощью которого можно осуществить поиск в списке сущностей. Поиск происходит по основным строковым полям сущностей данного
типа. Результатом поиска будет отсортированный по релевантности список сущностей данного типа, прошедших фильтрацию по переданной поисковой строке. В отличии от фильтрации выборки
с помощью параметра filter, при которой значения проверяются на точное совпадение указанным, при контекстном поиске проверка на совпадение не строгая.
Таким образом, если осуществлять фильтрацию вида ../entity/<entity_type>?filter=name=120 в отфильтрованную выборку попадут только те сущности, поле name
у которых имеет значение 120 и никакие другие. При контекстном поиске вида ../entity/<entity_type>?search=120 будут выведены как сущности с name равным
120, так и сущности, в имени (или в другом строковом поле) которых 120 является началом какого-то слова, например 12003, пазл детский 1200 штук и т.п.
Причем, если ввести несколько слов ../entity/<entity_type>?search=120 возврат и поиск идёт по полям name и description, то будут выведены как сущности с name равным 1200 и с description
равным возврат из-за деффекта, так и сущности с именем 777 с описанием розничный возврат на улице 120 летия.
- Примеры запросов контекстного поиска (значения должны быть urlencoded):
https://online.moysklad.ru/api/remap/1.2/entity/project?search=реструктуризацияhttps://online.moysklad.ru/api/remap/1.2/entity/move?search=ул.Вавиловаhttps://online.moysklad.ru/api/remap/1.2/entity/counterparty?search=петров
Оператор фильтрации "подобие"
В JSON API для строковых полей есть специальный оператор фильтрации "подобие".
+ ~ обычное подобие. Ищет любое вхождение подстроки, следующей после оператора, в значении поля. Например, ?filter=code~ms найдёт все сущности, у которых в коде встречается подстрока "ms".
+ ~= левое подобие. Ищет соответствие по префиксу значения. Например ?filter=code~=ms найдёт все сущности, у которых код начинается на "ms".
+ =~ правое подобие. Ищет соответствие по постфиксу. Например ?filter=code=~ms найдёт все сущности, у которых код оканчивается на "ms".
Операторы подобия работают исключительно с полями строкового типа и не учитывают регистр. К полям типа uuid и дата-время они неприменимы.
Вывод JSON с отступами
В JSON API можно получать ответы от сервера в виде pretty-print JSON (JSON с отступами вместо JSON в одну строку). Для этого нужно добавить специальный заголовок к запросу:
Lognex-Pretty-Print-JSON со значением true.
Использование цен без округления
В JSON API можно задавать цены позиций и себестоимость с дробными частями копеек. Для этого нужно добавить специальный заголовок к запросу:
X-Lognex-Precision со значением true.
Если не использовать этот заголовок, цены и себестоимость округляются до копеек.
Ссылки на файлы
В JSON API для скачивания файла формируется редирект на временный URL файла. Для корректной работы необходимо поддерживать обработку редиректов.
Замена ссылок объектами с помощью expand
В JSON API, в составе сущностей можно встретить ссылки на связанные объекты. Ссылки выводятся в формате Метаданных. Для того, чтобы вместо ссылок получить связанные объекты, не обязательно делать отдельные запросы для каждого из них. Вместо этого, вместе с запросом на получение сущности, нужно передать параметр expand. В качестве значения данного параметра нужно перечислить через запятую все необходимые поля-ссылки, на месте которых вы бы хотели видеть связанные объекты. В результате запроса с таким параметром, в ответе вы получите объект с развернутыми вложенными объектами вместо ссылок. К примеру, в документах, имеющих в составе поле agent, вместо ссылки на контрагента будет выведен объект со всеми полями сущности "Контрагент", описанными тут. Максимальный уровень вложенности expand : 3. Expand разрешен только на размере выборки не более 100. Если указан больший лимит, но указан expand, то данный параметр будет игнорироваться.
Также expand можно применять для результатов операций создания и обновления.
- Ниже показаны примеры использования expand на Возврате покупателя. В примерах представлены только поля meta и demand.
Возврат без expand
Пример запроса возврата без expand
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089"
-H "Authorization: Basic <Access-Token>"
Объект возврата покупателя в его обычном представлении, имеющий ссылку на отгрузку
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
...
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/f99544d7-4a98-11e6-8a84-bae50000007f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
}
Возврат с expand отгрузки
Пример запроса возврата с expand отгрузки Передаём параметр expand=demand.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089?expand=demand"
-H "Authorization: Basic <Access-Token>"
В ответ придёт возврат покупателя, у которого вместо ссылки на отгрузку, по которой производится возврат, будет вложенный объект со всеми полями данной отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089?expand=demand",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
...
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/f99544d7-4a98-11e6-8a84-bae50000007f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "f99544d7-4a98-11e6-8a84-bae50000007f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
...
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/f99544d7-4a98-11e6-8a84-bae50000007f/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"returns": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
]
}
}
Expand с глубиной 2
Пример запроса возврата c expand с глубиной 2 Теперь развернем поле agent у вложенной в возврат отгрузки (demand). В ответ придёт возврат покупателя с развёрнутой отгрузкой (demand), внутри которой будет развёрнутый объект контрагента (agent).
В данном запросе продемонстрирован уровень вложенности параметра expand равный двум.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089?expand=demand,demand.agent"
-H "Authorization: Basic <Access-Token>"
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089?expand=demand,demand.agent",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
...
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/f99544d7-4a98-11e6-8a84-bae50000007f?expand=agent",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
...
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
...
"name": "Агент1",
"code": "УТ0003074",
"externalCode": "kAgs4Xbhiz2Sp5oP2OCaB2",
"archived": false,
"legalTitle": "Общество с ограниченной ответственностью «Агент1»",
"legalAddress": "107023, г. Москва, Барабанный переулок, дом № 42, строение 2",
"inn": "7719864242",
"kpp": "771901001",
...
},
...
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/f99544d7-4a98-11e6-8a84-bae50000007f/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"returns": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
]
}
...
}
Создание отгрузки с expand
Развернем поле agent у создаваемой отгрузки.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand?expand=agent"
-H "Authorization: Basic <Access-Token>"
-H 'Content-Type: application/json' \
-d '{
"name": "0001",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
}
}'
В ответ придёт созданная отгрузка с развёрнутым объектом контрагента (agent).
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/1c3f30d2-88b9-11e7-9464-e4de00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#demand/edit?id=1c3f30d2-88b9-11e7-9464-e4de00000000"
},
"id": "1c3f30d2-88b9-11e7-9464-e4de00000000",
"accountId": "d8a2e973-6703-11e7-9464-e4de00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/d9335bf2-6703-11e7-9464-e4de0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=d9335bf2-6703-11e7-9464-e4de0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/d8a5d385-6703-11e7-9464-e4de00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-08-24 13:43:47",
"name": "0001",
"externalCode": "UoaXR1oZhS9LOHzdUi42R1",
"moment": "2017-08-24 13:43:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/d959dce8-6703-11e7-9464-e4de00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=d959dce8-6703-11e7-9464-e4de00000058"
}
}
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/d95915ff-6703-11e7-9464-e4de00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=d95915ff-6703-11e7-9464-e4de00000053"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/d9593e70-6703-11e7-9464-e4de00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=d9593e70-6703-11e7-9464-e4de00000054"
},
"id": "d9593e70-6703-11e7-9464-e4de00000054",
"accountId": "d8a2e973-6703-11e7-9464-e4de00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/d9335bf2-6703-11e7-9464-e4de0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=d9335bf2-6703-11e7-9464-e4de0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/d8a5d385-6703-11e7-9464-e4de00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-08-18 17:49:23",
"name": "ООО \"Поставщик\"",
"externalCode": "YWKWXePEi9jBAmxriBpc93",
"archived": false,
"created": "2017-07-12 16:13:08",
"companyType": "legal",
"legalTitle": "Общество с ограниченной ответственностью \"Поставщик\"",
"legalAddress": "г.Москва, ул.Строителей, д.12",
"inn": "7736570901",
"kpp": "773601001",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/d9593e70-6703-11e7-9464-e4de00000054/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [
"bbbvcc",
"ss"
],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/d9593e70-6703-11e7-9464-e4de00000054/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/d9593e70-6703-11e7-9464-e4de00000054/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/d9efdc3b-6703-11e7-9464-e4de00000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
}
},
"salesAmount": 4500
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/d955aa70-6703-11e7-9464-e4de00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=d955aa70-6703-11e7-9464-e4de00000051"
}
},
"created": "2017-08-24 13:43:48",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/1c3f30d2-88b9-11e7-9464-e4de00000000/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"payedSum": 0
}
Редактирование отгрузки с expand
Теперь обновим эту отгрузку и развернем у неё поля agent и organization. В ответ придёт изменённая отгрузка с развёрнутым объектом контрагента (agent) и развёрнутым объектом юрлица (organization).
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/1c3f30d2-88b9-11e7-9464-e4de00000000?expand=agent,organization"
-H "Authorization: Basic <Access-Token>"
-H 'Content-Type: application/json' \
-d '{
"name": "3738"
}`
Response 200 (application/json)
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/1c3f30d2-88b9-11e7-9464-e4de00000000?expand=agent,organization",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#demand/edit?id=1c3f30d2-88b9-11e7-9464-e4de00000000"
},
"id": "1c3f30d2-88b9-11e7-9464-e4de00000000",
"accountId": "d8a2e973-6703-11e7-9464-e4de00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/d9335bf2-6703-11e7-9464-e4de0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=d9335bf2-6703-11e7-9464-e4de0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/d8a5d385-6703-11e7-9464-e4de00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-08-24 13:53:07",
"name": "3738",
"externalCode": "UoaXR1oZhS9LOHzdUi42R1",
"moment": "2017-08-24 13:43:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/d959dce8-6703-11e7-9464-e4de00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=d959dce8-6703-11e7-9464-e4de00000058"
}
}
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/d95915ff-6703-11e7-9464-e4de00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=d95915ff-6703-11e7-9464-e4de00000053"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/d9593e70-6703-11e7-9464-e4de00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=d9593e70-6703-11e7-9464-e4de00000054"
},
"id": "d9593e70-6703-11e7-9464-e4de00000054",
"accountId": "d8a2e973-6703-11e7-9464-e4de00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/d9335bf2-6703-11e7-9464-e4de0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=d9335bf2-6703-11e7-9464-e4de0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/d8a5d385-6703-11e7-9464-e4de00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-08-18 17:49:23",
"name": "ООО \"Поставщик\"",
"externalCode": "YWKWXePEi9jBAmxriBpc93",
"archived": false,
"created": "2017-07-12 16:13:08",
"companyType": "legal",
"legalTitle": "Общество с ограниченной ответственностью \"Поставщик\"",
"legalAddress": "г.Москва, ул.Строителей, д.12",
"inn": "7736570901",
"kpp": "773601001",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/d9593e70-6703-11e7-9464-e4de00000054/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [
"bbbvcc",
"ss"
],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/d9593e70-6703-11e7-9464-e4de00000054/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/d9593e70-6703-11e7-9464-e4de00000054/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/d9efdc3b-6703-11e7-9464-e4de00000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
}
},
"salesAmount": 4500
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/d955aa70-6703-11e7-9464-e4de00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=d955aa70-6703-11e7-9464-e4de00000051"
},
"id": "d955aa70-6703-11e7-9464-e4de00000051",
"accountId": "d8a2e973-6703-11e7-9464-e4de00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/d9335bf2-6703-11e7-9464-e4de0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=d9335bf2-6703-11e7-9464-e4de0000002a"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/d8a5d385-6703-11e7-9464-e4de00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-07-12 16:13:09",
"name": "reqwy",
"externalCode": "PRLKDfmQgwj7TGtiYWrrZ3",
"archived": false,
"created": "2017-07-12 16:13:08",
"companyType": "legal",
"legalTitle": "reqwy",
"email": "erqw@ss.ru",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/d955aa70-6703-11e7-9464-e4de00000051/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"isEgaisEnable": false,
"payerVat": true,
"director": "Администратор",
"chiefAccountant": "Администратор"
},
"created": "2017-08-24 13:43:48",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/1c3f30d2-88b9-11e7-9464-e4de00000000/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"payedSum": 0
}
Ошибки
Ошибки
JSON API использует следующие ошибки:
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 1000 | Элемент URI не является идентификатором | Вероятнее всего вы пытаетесь обратиться к несуществующему ресурсу. Проверьте указанный вами URI, проверьте правильно ли вы указали ключевое слово сущности и полностью ли вы скопировали ID. |
| 1001 | Не указан идентификатор метаданных | При обращении к пользовательскому справочнику в URI должен быть указан корректный {id} метаданных данного справочника. Его можно уточнить, сделав запрос к метаданным настроек компании companysettings/metadata в массиве customEntities. |
| 1002 | Неопознанный путь: {путь} | Не удалось определить ресурс, по которому был сделан запрос. Проверьте URI по которому совершается запрос. |
| 1003 | Отсутствуют метаданные для типа {тип} | Для данного ресурса нельзя получить метаданные. Ещё раз проверьте документацию по сущности данного типа и убедитесь в наличии ресурса "Метаданные <наименование_сущности>" |
| 1004 | Ошибка при формировании результата: {текст ошибки} | При разборе переданного объекта произошла ошибка. Проверьте корректность переданных данных. |
| 1005 | Неизвестный тип: {тип} | Тип сущности, указанный в URI, не может быть найден. Проверьте корректность ключевого слова. |
| 1006 | Создание объектов с указанным идентификатором запрещено | При создании сущности не нужно указывать в URI запроса id сущности. Запрос на создание должен происходить по тому же URI, по которому происходит запрос на получение списка сущностей данного типа. |
| 1007 | Неизвестное поле: {имя поля} | При обновлении сущности указанное поле не было найдено. Проверьте правильность написания имени поля, а также убедитесь что данное поле присутствует среди атрибутов сущностей этого типа. |
| 1008 | Ошибка при загрузке объекта с типом '{тип}' и идентификатором '{id}' | Не удалось загрузить сущность с данным id. Проверьте корректность id. Убедитесь что сущность с данным id присутствует среди списка сущностей данного типа (возможно сущность с данным id была удалена). |
| 1009 | Редактирование объектов типа '{тип}' не поддерживается | Сущность которую вы пытаетесь обновить - только для чтения. Изменение её атрибутов не предусмотрено. |
| 1010 | Удаление объектов типа '{тип}' не поддерживается | Нельзя удалить сущность данного типа. Проверьте, есть ли среди операций данного типа сущностей операция удаления. |
| 1011 | Создание объектов типа '{тип}' не поддерживается | Нельзя создать сущность данного типа. Проверьте, есть ли среди операций данного типа сущностей операция создания. |
| 1012 | Не указан идентификатор объекта | Для операций обновления и удаления необходимо указывать id сущности, над которой производится операция. |
| 1013 | Удаление вложенных объектов не поддерживается | Невозможно удалить вложенные сущности, такие как счета контрагентов. Если вы хотите обнулить значение поля: попробуйте передать null в качестве значения данного поля в запроса не обновление. В случае с позициями документов - вы можете передать пустой массив. Это будет эквивалентно удалению сразу всех позиций из документа. |
| 1014 | Неверное значение '{значение}' параметра фильтрации '{имя параметра}' | Вы указали значение неподдерживаемого типа для данного параметра (например передали int вместо boolean). Возможно ошибка в неправильном формате даты и времени. |
| 1015 | Указана неверная версия в url: {url} | Проверьте необходимую версию API в url по которому вы делаете запрос. online.moysklad.ru/api/1.x/... Версии API различаются между собой по количеству доступных ресурсов, а также по способу обработки данных и именно поэтому являются важным элементом идентификации того или иного ресурса. |
| 1016 | Доступ запрещен: у вас нет прав на просмотр данного объекта | Администратор учётной записи ограничил ваши права на просмотр сущностей данного типа. Свяжитесь с ним для выяснения подробностей. |
| 1017 | Доступ запрещен: у вас нет прав на редактирование данного объекта | Администратор учётной записи ограничил ваши права на редактирование сущностей данного типа. Свяжитесь с ним для выяснения подробностей. |
| 1018 | Доступ запрещен: у вас нет прав на удаление данного объекта | Администратор учётной записи ограничил ваши права на удаление сущностей данного типа. Свяжитесь с ним для выяснения подробностей. |
| 1020 | Родительский объект с типом '{тип}' и идентификатором '{id}' не существует | Неверный id родительской сущности. |
| 1021 | Объект с типом '{тип}' и идентификатором '{id}' не найден | Не удалось загрузить сущность данного типа с данным id. Проверьте корректность id. Убедитесь что сущность с данным id присутствует среди списка сущностей данного типа (возможно сущность с данным id была удалена) |
| 1022 | Ошибка при создании объекта | Ошибка в процессе создания сущности данного типа. |
| 1023 | Ошибка сохранения объекта: дочерний объект с типом '{тип}' и идентификатором '{id}' уже используется и не может быть удален | Невозможно удалить объект во вложенной коллекции т.к. он уже где-то используется. Например, может возникнуть при удалении позиции из документа, по которому есть возврат, в котором присутствует данная позиция. |
| 1024 | Ошибка сохранения объекта: изменять стандартные объекты запрещено | Вы пытаетесь изменить сущность, которая создаётся по умолчанию в сервисе МойСклад сразу после регистрации учётной записи. Это делать запрещено. (Например изменение стандартных стран и единиц измерения) |
| 1025 | Ошибка удаления объекта: удалять стандартные объекты запрещено | Удаление стандартных объектов, таких как стандартные единицы измерения, валюты, страны и т.п. не поддерживается. |
| 1026 | Обновление объектов типа '{тип}' не поддерживается | Обновление объектов указанного типа не поддерживается в JSON API. |
| 1027 | Запрос не содержит объектов | Тело запросов на создание/обновление должно представляться в виде объекта либо массива JSON. |
| 1028 | Объект уже используется и не может быть удален | Сущность используется в сущностях и документах, перечисленных в ошибке, поэтому её нельзя удалить. Например нельзя удалить товар, который используется в качестве позиции в каком-либо документе. |
| 1029 | Шаблоны для типа '{тип}' не поддерживаются | Невозможно создать предзаполненную сущность данного типа. |
| 1030 | Поле для фильтрации '{имя поля}' может быть указано только один раз | Убедитесь, что каждое поле используется в параметрах фильтрации лишь единожды. |
| 1031 | Ошибка генерации шаблона: невозможно создать шаблон объекта на основе указанных полей | Невозможно создать предзаполненную сущность данного типа на основе другой. |
| 1032 | Ошибка фильтрации: характеристика '{имя/id характеристики}' не существует | У данной модификации нет характеристики с указанным id. Проверьте правильность введённого id и список характеристик для данной модификации. |
| 1033 | Ошибка фильтрации: фильтрация по характеристикам модификаций совместима только с группировкой по модификациями | В отчётах при передаче значения параметра groupBy отличного от variant невозможна фильтрация по характеристикам модификаций. |
| 1034 | Ошибка фильтрации: {текст ошибки} | Ошибка в процессе обработки фильтров. Проверьте переданные фильтры на валидность. Подробнее о параметрах фильтрации вы можете прочесть в соответствующем разделе документации или в документации по сущности, к которой вы пытаетесь применять фильтры. |
| 1035 | Ошибка фильтрации: неверный формат даты параметра фильтрации | Проверьте значение даты и времени. Оно должно соответствовать формату yyyy-MM-dd HH:mm:ss |
| 1036 | Ошибка при формировании метаданных | Описание Внутренняя ошибка сервиса. Попробуйте повторить запрос. |
| 1037 | Неверно указан Content-Type запроса | Описание Возможно ресурс, к которому вы обращаетесь, требует form-data вместо JSON (или наоборот). |
| 1038 | Ошибка в адресе запроса | Описание Проверьте, указываете ли вы валидный адрес запроса. |
| 1039 | Операция {HTTP метод} не поддерживается для данного ресурса | Описание Проверьте метод, с которым вы обращаетесь к ресурсу. Убедитесь, что в документации ресурса этот метод описан и его можно применить. |
| 1040 | Неверно заданы параметры запроса | Описание Один или несколько параметров запроса заданы некорректно. Проверьте формат параметров согласно документации. |
| 1041 | Неверное значение '{значение}' параметра фильтрации '{имя параметра}', допустимые значения: '{список допустимых значений}' | Значение параметра должно входить в список допустимых значений. |
| 1042 | Неверное значение '{значение}' параметра сортировки '{имя параметра}', допустимые значения: '{список допустимых значений}' | Значение параметра должно входить в список допустимых значений. |
| 1043 | Ваш тарифный план не позволяет работать с CRM | Ваш тариф не подходит для работы с CRM. |
| 1044 | Превышен максимальный размер запроса | Максимальный размер запроса 10 МБ. |
| 1045 | Доступ запрещен: у вас нет прав на создание данного объекта | Администратор учётной записи ограничил ваши права на создание сущностей данного типа. Свяжитесь с ним для выяснения подробностей. |
| 1046 | Дочерняя сущность не может изменять свою родительскую сущность | Возможно вы попробовали подставить позицию(и) из одного документа в другой (Попробуйте удалить meta, id, accountId из документа и позиции(й)). |
| 1047 | Вы не можете обновить поле syncId в запросе на обновление сущности | Поле syncId может быть указано только при создании сущности. Его нельзя изменить в запросе на обновление. |
| 1052 | Неверный формат UUID | Проверьте сгенерированные вами UUID на корректность. |
| 1056 | Ошибка аутентификации: {текст ошибки аутентификации} | Описание Проверьте указанные для аутентификации данные. Возможно для данного ресурса требуется другой вид аутентификации. |
| 1058 | Не удалось декодировать параметры запроса из URL | Описание Проверьте запрос. Вероятно, в строке присутствуют параметры, которые не были urlencoded. |
| 1059 | Некорректный сервер в идентификаторе объекта: '{идентификатор}' | Описание Идентификатор объекта содержит сервер, отличный от online.moysklad.ru. |
| 1060 | Некорректный тип данных в meta сущности, поле type | Описание Тип данных указанный в поле type метаданных сущности не совпадает с ожидаемым типом. |
| 1061 | Отсутствует доступ к API для данного пользователя | Описание Отсутствует доступ к API для данного пользователя - обратитесь к администратору аккаунта. |
| 1062 | Неверное значение заголовка 'Accept'. Поддерживается только значение 'application/json;charset=utf-8' | Описание Значение заголовка 'Accept' может быть только application/json;charset=utf-8. |
| 1063 | Ошибка сортировки: неизвестное поле '{название поля}' или сортировка для данного поля не поддерживается | Описание Сортировка для данного поля не поддерживается. Возможно, поле не входит в список поддерживаемых полей. |
| 1064 | Доступ запрещен: у вас нет прав на печать данных объектов | Описание Администратор учётной записи ограничил ваши права на печать сущностей данного типа. Свяжитесь с ним для выяснения подробностей. |
| 1065 | Ошибка сохранения объекта: объект уже изменен/удален в параллельном запросе | Описание Ошибка возникает при попытке изменить объект из нескольких параллельных запросов к API. |
| 1066 | Ошибка удаления объекта: объект нельзя переместить в корзину | Описание Удаление в корзину возможно только для документов. Проверьте, является ли удаляемый объект документом. |
| 1067 | Ошибка удаления объекта: использование корзины отключено | Описание Отключена опция для удаления документов в корзину - обратитесь к администратору аккаунта. |
| 1068 | Точка продаж отключена. Обратитесь к администратору аккаунта | Описание Убедитесь, что Ваш тарифный план поддерживает работу с точками продаж. |
| 1069 | Ошибка запроса: несовместимые параметры запроса: '{несовместимые параметры}' | Описание Не все параметры запроса могут быть применены одновременно, они перечисленны в тексте ошибки: '{несовместимые параметры}'. Следует исключить параметры из запроса, учитывая совместимость. |
| 1999 | Неизвестная ошибка | Описание Произошла непредвиденная ошибка. Пожалуйста, обратитесь в поддержку сервиса МойСклад подробно изложив условия при которых эта ошибка произошла. |
Ошибки формата
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 2000 | Ошибка формата: отсутствует начало объекта | В данном месте ожидалось начало объекта. Проверьте тело запроса. |
| 2001 | Ошибка формата: входящий запрос не соответствует формату JSON | Данные должны быть отправлены в формате JSON. Если это так, а ошибка всё-таки возникает - попробуйте добавить Header Content-Type со значением application/json. |
| 2002 | Ошибка формата: неименованное внутреннее поле типа массив | Проверьте указали ли вы наименование поля типа массив. Возможно присутствуют лишние открывающиеся/закрывающиеся скобки в теле запроса. |
| 2003 | Ошибка формата: неименованное внутреннее поле типа объект | Проверьте указали ли вы наименование поля типа "объект". Возможно присутствуют лишние открывающиеся/закрывающиеся скобки в теле запроса. |
| 2004 | Ошибка формата: вложенные массивы недопустимы | В рамках JSON API не обрабатываются массивы массивов. Проверьте тело запроса на корректность. |
| 2005 | Ошибка формата: входящий JSON должен начинаться либо с объекта, либо с массива | Отсутствует открывающаяся фигурная/квадратная скобка в начале тела запроса. |
| 2006 | Ошибка формата: слишком большая вложенность объектов | Максимальная глубина вложенности в JSON API - 10. Скорректируйте тело запроса и убедитесь, что это ограничение не нарушается. |
| 2007 | Ошибка формата: слишком большое число вложенных объектов | В JSON API в массиве может содержаться не более 100 объектов. |
| 2008 | Ошибка формата: запрос на шаблон не должен содержать массив | С помощью запроса по ресурсу {entity_name}/new можно создать только 1 шаблон. Передача массива значений не поддерживается. |
| 2009 | Ошибка формата: запрос на создание/обновление одной сущности не должен содержать массив | При обновлении отдельной сущности подразумевается, что в теле запроса будет передано её новое представление (одно). В теле запроса должен быть один корневой объект. |
| 2010 | Ошибка формата: отсутствует href для meta поля '{доп. сообщение}' | В переданном объекте метаданных отсутствует поле href. Проверьте тело запроса. |
| 2011 | Ошибка формата: отсутствует type для meta поля '{доп. сообщение}' | В переданном объекте метаданных отсутствует поле type. Проверьте тело запроса. |
| 2012 | Ошибка формата: неизвестный type для meta поля '{доп. сообщение}' | В переданном объекте метаданных указан неизвестный тип. Проверьте тело запроса. Возможно вы указываете неверное ключевое слово для сущности. Проверьте документацию по данной сущности и убедитесь в правильности передаваемого type. |
| 2013 | Ошибка формата: неправильное значение href для meta поля '{доп. сообщение}' | Переданный href указывает на несуществующий объект. Убедитесь в корректности ссылки. Ошибка может быть в версии API, типе ресурса (entity/pos/report), ключевом слове сущности/(отчёта), id сущности. |
| 2014 | Ошибка формата: отсутствует meta для поля '{имя поля}' | Для полей типа метаданных (ссылок на другие связанные объекты) необходимо значение в виде объекта, содержащего meta. |
| 2015 | Ошибка формата: отсутствует id для поля '{имя поля}' | При передаче вложенных сущностей в виде полей необходимо указывать id этих сущностей. |
| 2016 | Ошибка формата: значение поля '{имя поля}' не соответствует типу {тип поля} | Для указанного поле передано значение неверного типа. Исправьте тело запроса. |
| 2017 | Ошибка формата: неизвестная ошибка | Не удалось однозначно классифицировать ошибку. Убедитесь что формат передаваемых вами данных соответствует требуемому. Посмотрите примеры запросов в документации по используемой вами сущности. |
| 2018 | Ошибка формата: отсутствует поле |
Вы не указали обязательное поле объекта meta. |
| 2021 | Ошибка формата: в объектах типа '<тип>' полю '<наименование поля>' не может быть присвоен объект типа <тип объекта> | Для сущностей данного типа у указанного поля не может быть выставлено указанное значение. Например, нельзя полю agent отгрузки выставить значение типа employee, тогда как тому же полю входящего платежа можно выставить значение типа employee. |
| 2022 | Ошибка формата: слишком большое число элементов вложенной коллекции | Вложенная коллекция может иметь в составе не более 100 элементов. |
| 2024 | Ошибка формата: href указывает на сущность неправильного типа '<тип>', требуется '<тип>' | Переданная ссылка href указывает на сущность неправильного типа. |
Общие ошибки валидации
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 3000 | Ошибка сохранения объекта: поле '{имя поля}' не может быть пустым или отсутствовать | Необходимое поле не может содержать пустого значения или отсутствовать. Все необходимые поля можно посмотреть в документации по сущности, с которой вы работаете, под заголовком "Атрибуты сущности". Такие поля помечены как Необходимое. |
| 3001 | Ошибка сохранения объекта: поле '{имя поля}' не может быть изменено | Вы пытаетесь изменить поле являющееся полем только для чтения. Все read-only поля можно посмотреть в документации по сущности, с которой вы работаете, под заголовком "Атрибуты сущности". Такие поля помечены как Только для чтения. |
| 3002 | Ошибка сохранения объекта: поле '{имя поля}' не может иметь отрицательное значение | Данное поле принимает только числовые значения больше либо равные нулю. |
| 3003 | Ошибка сохранения объекта: поле '{имя поля}' должно быть больше нуля | Данное поле принимает только числовые значения больше нуля. Эта ошибка также возвращается при указании значений, которые при |
округлении до 4-го знака после запятой будут равны нулю (т.е. для значений < 0.00005).
|3004|Ошибка сохранения объекта: поле '{имя поля}' не соответствует полю связанного объекта|Поле возврата не соответствует полю документа-основания. Невозможно изменить значения полей agent, currency, vatIncluded в возвратах на несоответствующие значениям этих же полей в документе-основании.
|3005|Ошибка сохранения объекта: неверное значение '{значение}' поля '{имя поля}'. Допустимые значения: {список значений}|Вы пытаетесь присвоить несуществующее значение полю типа "перечисление"(enum). Проверить все возможные значения этого поля вы можете в документации по данной сущности в разделе "Атрибуты сущности".
|3006|Ошибка сохранения объекта: нарушено ограничение уникальности параметра '{имя параметра}'|У указанного поля/параметра должно быть уникальное значение в системе. Например, если включена проверка на уникальность номеров операций, name у разных документов не может быть одинаковым.
|3007|Ошибка валидации сохраняемого объекта: '{объект}'|Ошибка при обмене. Проверьте, соблюдает ли все условия передаваемый вами объект.
|3008|Ошибка сохранения объекта: значение поля '{имя поля}' превышает максимально допустимое значение|Значение числового поля превышает максимально допустимое значение: 9 999 999 999.
|3009|Ошибка валидации: поле '{имя поля}' не может быть пустым или отсутствовать|Необходимое поле не может содержать пустого значения или отсутствовать.
|3010|Ошибка валидации: нельзя привязать документ из корзины к платежу|Документ из корзины не может быть привязан к платежу.
|3011|Ошибка валидации штрихкода: невозможно добавить к сущности штрихкод длиной более 255 символов|Исправьте длину штрихкода и попробуйте повторить запрос.
Коды ошибок для Точек продаж
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 4000 | Указанная точка продаж не активна | Для выполнения операции необходимо активировать точку продаж. |
Коды ошибок для Отчётов комиссионера
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 5000 | Неверный тип договора для отчёта комиссионера. Могут быть использованы только договоры типа 'Договор комиссии'(Comission). | При создании / обновлении отчёта комиссионера обязательно указывать договор, который принадлежащит указанному контрагенту и имеет тип 'Договор комиссии'. |
| 5001 | Неверно указан период отчёта комиссионера: конец периода не может быть раньше начала. | Проверьте указанные даты. Дата в поле commissionPeriodStart должна быть раньше даты в поле commissionPeriodEnd. |
| 5002 | Указанный договор заключен с контрагентом, отличным от указанного в поле agent | При создании / обновлении отчёта комиссионера обязательно указывать договор, который принадлежащит указанному контрагенту и имеет тип 'Договор комиссии'. |
| 5003 | Указанный договор заключен с юрлицом, отличным от указанного в поле organization | Организация должна соответствовать организации, указанной в договоре. |
Коды ошибок для Характеристик модификаций
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 10000 | Ошибка сохранения характеристики модификации: поля 'id' и 'name' не могут быть пустыми | При обновлении характеристик модификации необходимо указывать вышеуказанные поля. Исправьте тело запроса. |
| 10001 | Ошибка сохранения характеристики модификации: поле 'id' ссылается на несуществующую характеристику | По переданному id не удалось найти соответствующую характеристику. Убедитесь в правильности id и повторите запрос. |
Коды ошибок для Статусов
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 11000 | Ошибка инициализации статуса: отсутствует информация о родительской сущности | Не удалось найти документ, к которому должен быть привязан данный статус. Проверьте id документа, а также, в случае обновления, убедитесь, что документ с данным id не был удалён. |
| 11001 | Ошибка инициализации статуса: статус с именем '{Наименование статуса}' не найден | Проверьте в метаданных сущностей данного типа, что статус с передаваемым именем существует, и исправьте запрос. |
Коды ошибок для Розничных смен (POS)
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 12000 | Ошибка открытия розничной смены: розничная смена находится в корзине | Данный syncId уже был использован для открытия другой смены. Данная смена уже была удалена. Для открытия новой смены сгенерируйте новый syncId. |
| 12001 | Ошибка открытия розничной смены: розничная смена закрыта | Данный syncId уже был использован для открытия другой смены. Данная смена уже была закрыта. Переоткрыть её невозможно. Для открытия новой смены сгенерируйте новый syncId. |
| 12002 | Ошибка закрытия розничной смены: розничная смена удалена | По переданному id смены не было найдено соответствующего объекта. Смена с данным id либо не существовала, либо была удалена. Проверьте правильность переданного id смены. |
| 12003 | Ошибка закрытия розничной смены: розничная смена находится в корзине | Смена с указанным id находится в корзине. Проверьте правильность указанного вами id смены. |
| 12004 | Ошибка закрытия розничной смены: розничная смена закрыта | Смена с указанным id находится уже была закрыта. Повторное закрытие смены невозможно. Проверьте правильность указанного вами id смены. |
| 12005 | Ошибка открытия розничной смены: не найдена точка продаж | При открытии смены не была найдена точка продаж с указанным id. Проверьте id точки продаж, на которой должна быть открыта новая смена. |
| 12006 | Ошибка открытия розничной смены: параметр 'retailShift' отсутствует или имеет неверный формат | Убедитесь в наличии параметра 'retailShift'. |
Коды ошибок для Отчётов Остатков
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 13000 | Пустой идентификатор операции | Вы запросили отчёт Остатки по операции, не указав id операции. Убедитесь что id передаётся в качестве параметра. |
| 13001 | Операция с указанным идентификатором не найдена | Не удалось найти операцию с указанным operation.id. Проверьте передаваемый вами id, а также убедитесь что операция с данным id не была удалена. |
| 13002 | Операция не может быть выполнена для указанного типа '{тип документа}' документа | Отчёт Остатки по операциям доступен только для операций типа Отгрузка, Розничная продажа, Заказ покупателя. |
| 13003 | Отсутствует доступ к отчету Остатки | У пользователя отсутствует доступ к отчету Остатки. |
Коды ошибок для Доп. поля
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 14000 | Ошибка сохранения дополнительного поля: поле '{наименование поля}' не относится к реестру '{тип сущности}' | В своём запросе пытаетесь использовать доп.поля другого типа сущности. Сделайте запрос метаданных по данному типу сущности и используйте доп. поля которые придут в ответ. |
| 14001 | Ошибка сохранения дополнительного поля: обновление дополнительных полей типа 'Файл' не поддерживается | Поле типа файл обновить нельзя. |
| 14002 | Ошибка сохранения дополнительного поля: родительская сущность не поддерживает дополнительные поля | Сущности данного типа не могут иметь доп. полей. Уточнить список типов сущностей, которые могут иметь доп. поля можно в разделе Работа с дополнительными полями |
| 14003 | Ошибка сохранения дополнительного поля: идентификатор метаданных указывает на несуществующий объект | Не удалось найти доп поле с указанным id. Проверьте список доп полей и их id с помощью ресурса метаданных сущности. |
| 14004 | Ошибка сохранения дополнительного поля: для объекта типа 'пользовательский справочник' необходимо указать поле meta или name | Хотя бы одно из вышеуказанных полей не должно быть пустым. |
| 14005 | Ошибка сохранения дополнительного поля типа 'Файл': размер файла превышает максимально допустимый (10 мб) | Невозможно загрузить в качестве значения доп. поля файл размером более 10 мб. |
| 14006 | Ошибка сохранения дополнительного поля типа 'Файл': отсутствует имя файла | Поле filename у значения доп. поля типа Файл должно быть заполнено. |
| 14007 | Ошибка сохранения дополнительного поля типа 'Файл': отсутствует поле content | Поле content у значения доп. поля типа Файл должно быть заполнено. |
| 14008 | Ошибка сохранения дополнительного поля типа 'Файл': недостаточно места в хранилище для сохранения файла | Место в хранилище, выделенное для вашего аккаунта, закончилось. |
| 14009 | Ошибка сохранения дополнительного поля типа '{наименование типа поля}': отсутствует поле value | Поле value у значения доп. поля типа '{наименование типа поля}' должно быть заполнено. |
Коды ошибок для Модификаций
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 15000 | Ошибка сохранения модификации: модификация с данным набором характеристик уже существует для данного товара | Невозможно иметь 2 модификации товара, у которых наборы значений характеристик будут совпадать. Убедитесь что это условие не нарушается. Иначе: используйте уже существующую модификацию. |
| 15001 | Ошибка сохранения модификации: должны быть заданы характеристики | При создании/обновлении модификации переданный массив характеристик не может отсутствовать или быть пустым. |
| 15002 | Ошибка сохранения модификации: нельзя создать модификацию услуги | Поддерживаются только модификации товаров. Убедитесь в правильности URI по которому происходит запрос. |
| 15003 | Ошибка сохранения модификации: нельзя создать модификацию алкогольного товара | Поддерживаются только модификации обычных товаров. Убедитесь в правильности URI по которому происходит запрос. |
| 15004 | Ваш тарифный план не позволяет работать с модификациями | Работа с модификациями не поддерживается на тарифах Бесплатный и Индивидуальный. |
Коды ошибок для Товаров
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 16000 | Ошибка сохранения товара: свойства алкогольной продукции не могут быть отрицательными | Алкогольные поля "код алкогольной продукции", "крепость" и "объём" должны принимать значение строго большее 0. |
| 16001 | Ошибка сохранения товара: весовой товар не может использовать учет по серийным номерам | Товар не может одновременно быть весовым и использовать учёт по серийным номерам. Это - взаимоисключающие признаки. |
| 16002 | Ошибка сохранения товара: нельзя отключить серийный учёт | Если серийный учет однажды включен, то его уже нельзя отключить. В ином случае вы можете создать новый товар. |
| 16003 | Ошибка сохранения товара: у изображения отсутствует контент | При передаче изображение в составе товара в запросе на создание товара необходимо указывать поле content |
| 16004 | Ошибка сохранения товара: невозможно преобразовать поле content в изображение | Содержимым поля "content" должно быть изображение закодированное в формате base64 с расширением jpg или png. |
| 16005 | Ошибка сохранения товара: Недостаточно места в хранилище. | Место в хранилище, выделенное для вашей учётной записи закончилось. |
| 16006 | Ошибка сохранения товара: размер изображения превышает максимально допустимый(3 мб) | Попробуйте уменьшить размер изображения. |
| 16007 | Ошибка сохранения товара: у изображения отсутствует имя файла | При загрузки изображения необходимо указать непустое имя файла в поле filename. |
| 16008 | Ошибка сохранения товара: для использования упаковок нужно указать единицу измерения товара | Для использования упаковок должна быть задана единица измерения товара |
Коды ошибок для Документов
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 17000 | Ошибка сохранения документа: счет организации не принадлежит указанной организации | Убедитесь что вы указываете подходящий счёт. Если вы обновляете поле organization вместе с ним также должно обновляться поле organizationAccount. |
| 17001 | Ошибка сохранения документа: счет контрагента не принадлежит указанному контрагенту | Убедитесь что вы указываете подходящий счёт. Если вы обновляете поле agent вместе с ним также должно обновляться поле agentAccount. |
| 17002 | Ошибка сохранения позиции документа: серийный номер не может быть пустым | Серийный номер не может быть пустой строкой. |
| 17003 | Ошибка сохранения позиции документа: количество зарезервированных товаров не может превышать общее количество | Количество зарезервированного товара позиции документа не может превышать общее количество товара по документу. |
| 17004 | Ошибка сохранения позиции документа: количество товаров в ожидании не может превышать общее количество | Количество ожидаемого товара позиции документа не может превышать общее количество товара по документу. |
| 17005 | Ошибка сохранения связанного документа: отсутствует ссылка на документ-основание | При сохранении связанного документа необходима ссылка на документ-основание (например при сохранении возврата необходима ссылка на продажу). |
| 17006 | Ошибка сохранения связанного документа: несовместимые типы документов - '<тип1>' и '<тип2>' | В качестве связи вы указали документ несоответствующего типа. |
| 17007 | Ошибка сохранения позиции документа: НДС не может быть больше 100 | Процент НДС может принимать значения от 0 до 100. |
| 17008 | Ошибка сохранения позиции документа: скидка не может быть больше 100 | Процент скидки может принимать значения от 0 до 100. |
| 17009 | Ошибка сохранения документа: дата '{тип документа}' не попадает в открытый для редактирования период | Данный документ относится к закрытому периоду. Редактирование документа невозможно. |
| 17010 | Ошибка сохранения документа: вы не можете проводить документы со складом-приемником из другого отдела | В метаданных документа запрещено проводить документы со складом-приемником из другого отдела. |
| 17011 | Ошибка сохранения документа: вы не можете проводить документы со складом-источником из другого отдела | В метаданных документа запрещено проводить документы со складом-источником из другого отдела. |
| 17012 | Ошибка сохранения документа: вы не можете сохранять документы со складом-приемником из другого отдела | В метаданных документа запрещено сохранять документы со складом-приемником из другого отдела. |
| 17013 | Ошибка сохранения документа: вы не можете сохранять документы со складом-источником из другого отдела | В метаданных документа запрещено сохранять документы со складом-источником из другого отдела. |
| 17014 | Ошибка сохранения документа: вы не можете снять проведение у документа типа <тип>, по которому был проведен возврат | Нельзя снять проведение у данного документа, поскольку для него уже был проведен возврат. |
| 17016 | Ошибка сохранения документа: комплект не может быть в составе позиции документа типа {тип_документа} | Комплект не может быть позицией в следующих документах: заказ поставщику, счет поставщика, приемка, возврат поставщику, выданный отчет комиссионера, полученный отчет комиссионера, списание, оприходование, перемещение, инвентаризация, тех. карта, тех. операция, внутренний заказ. |
| 17018 | Ошибка сохранения документа: количество комплектов должно быть целым числом | Количество комплектов в позиции должно быть целым числом |
Коды ошибок для Продаж/Отгрузок
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 18000 | Ошибка сохранения продажи: сумма 'cashSum' и 'noCashSum' не соответствует сумме по документу | Сумма полей cashSum и noCashSum должна быть равна значению поля sum или отличаться менее чем на 10 единиц. В случае создания документа и указании вышеупомянутых полей в теле запроса, ответственность за подсчёт sum ложится на пользователя. sum считается как общая сумма по всем позициям документа. |
| 18002 | Ошибка сохранения документа: отгрузка по комиссионному договору не может содержать комплект в составе позиций | В отгрузку нельзя добавить комплект, если для неё указан договор типа "Комиссионный"". |
Коды ошибок для Возвратов
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 19000 | Ошибка сохранения возврата: розничная смена уже закрыта | Нельзя сохранить возврат в закрытую розничную смену. Убедитесь что используете идентификатор активной смены. |
| 19001 | Ошибка сохранения розничного возврата: поля 'cashSum' и 'noCashSum' являются обязательными для возврата без основания | Поля 'cashSum' и 'noCashSum' являются обязательными для возврата без основания. Убедитесь, что они заполнены. |
| 19002 | Ошибка сохранения розничного возврата: сумма 'cashSum' и 'noCashSum' не соответствует сумме по документу | Сумма полей cashSum и noCashSum должна быть равна значению поля sum или отличаться менее чем на 10 единиц. В случае создания документа и указании вышеупомянутых полей в теле запроса, ответственность за подсчёт sum ложится на пользователя. sum считается как общая сумма по всем позициям документа. |
Коды ошибок для Приёмок
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 20000 | Ошибка сохранения приемки: нельзя указать накладные расходы с договором комиссии | Если к приёмке привязан договор типа "Договор комиссии", то нельзя указать какое-либо значение в поле overhead. |
Коды ошибок для Перемещений
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 21000 | Ошибка сохранения перемещения: нельзя провести перемещение со склада на этот же склад | Убедитесь, что в полях sourceStore и targetStore указываете склады с разными идентификаторами. |
Коды ошибок для Платежей
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 22000 | Ошибка сохранения платежа: распределенная сумма превышает сумму платежа | Сумма, указанная в linkedSum больше чем sum платежа. |
| 22001 | Ошибка сохранения платежа: платеж содержит повторяющиеся привязанные документы | Вы пытаетесь привязать платеж к документу более одного раза. |
| 22002 | Ошибка сохранения платежа: некорректная статья расходов: '{категория расходов}' | Платежу нельзя присвоить данную статью расходов. |
Коды ошибок для Групп товаров
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 23000 | Ошибка сохранения группы: нельзя указывать в качестве родительской группы саму группу | Группа не может в качестве родительской ссылаться на саму себя. |
| 23001 | Ошибка сохранения группы: нельзя указывать в качестве родительской группы вложенную группу | Группа не может в качестве родительской группы ссылаться на группу, которая является ее дочерней группой. |
Коды ошибок для Инвентаризаций
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 24001 | Ошибка создания шаблона списания: инвентаризация не требует проведения списания | Инвентаризация не содержит недостачи, либо все необходимые списания уже созданы. |
| 24002 | Ошибка создания шаблона оприходования: инвентаризация не требует проведения оприходования | Инвентаризация не содержит избытка, либо все необходимые оприходования уже созданы. |
| 24003 | Ошибка сохранения инвентаризации: услуга не может быть позицией инвентаризации | Услуга не может быть позицией инвентаризации. |
| 24004 | Ошибка сохранения инвентаризации: инвентаризация не может содержать дублирующихся позиций | Товар/Услуга/Модификация/Серия/Комплект может быть добавлен(а) в инвентаризацию только единожды. |
Коды ошибок для Технологических операций
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 25001 | Ошибка сохранения технологической операции: позиции операции не соответствуют позициям тех. карты | Проверьте соответствие продуктов и материалов тех. операции и тех. карты. |
| 25002 | Ошибка сохранения технологической операции: состав позиций не может быть изменён | Состав продуктов и материалов тех. операции не может быть изменён. |
Коды ошибок для Заказов на производство
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 26001 | Ошибка сохранения заказа на производство: материалы заказа не соответствуют материалам тех. карты | Проверьте соответствие материалов заказа на производство и тех. карты. |
| 26002 | Ошибка сохранения заказа на производство: новые товары не могут быть добавлены в заказ | Проверьте заказ на наличие новых товаров. |
Коды ошибок для Прайс-листов
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 27000 | Ошибка сохранения описания таблицы, '{описание ошибки}' | На создание таблицы Прайс-листа налагаются следующие ограничения: для описанного столбца не может отсутствовать или быть пустым название, в пределах одного Прайс-листа столбцы должны быть уникальные по названию. |
| 27001 | Ошибка сохранения позиции, для указанного имени столбца не найден столбец в описании таблицы | Значение ячеек в позициях Прайс-листа соотносятся со столбцами по названию. Нельзя указывать для ячейки название несуществующих в определении Прайс-листа столбцов. |
| 27002 | Ошибка сохранения позиции, нельзя в прайс-листе указывать повторяющиеся позиции | Нельзя в прайс-листе указывать повторящиеся позиции, например, товар или его модификацию дважды. |
| 27003 | Ошибка сохранения позиции, нельзя в прайс-листе указывать серии | Нельзя в прайс-листе указывать серии, только товары, услуги и модификации. |
Коды ошибок для Контрагентов
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 28000 | Ошибка сохранения контрагента: неизвестный тип цены: '<Тип цены>' | Неизвестный тип цены. Список допустимых можно запросить в метаданных товаров. |
Коды ошибок для Комплектов
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 29000 | Ошибка сохранения комплекта: некорректное число компонентов | Поддерживается от одного до пятидесяти компонентов в одном комплекте. |
| 29001 | Ошибка сохранения комплекта: дополнительные расходы и состав компонентов не могут быть изменены, так как комплект уже используется | Уберите зависимые комплекты из документов. |
| 29002 | Ошибка сохранения комплекта: комплект содержит повторяющиеся компоненты | Проверьте состав компонентов комплекта и попробуйте снова. |
| 29003 | Ошибка сохранения комплекта: компонент комплекта не может быть комплектом, серией, алкогольным товаром или товаром на серийном учете | Проверьте состав компонентов комплекта и попробуйте снова. |
Коды ошибок для Веб-хуков
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 30000 | Ошибка сохранения webhook: неподдерживаемый тип сущности '{тип}' | В веб-хуках можно использовать любые типы сущностей, доступные через Remap API, кроме вложенных. Например, product или demand. |
| 30001 | Ошибка сохранения webhook: неизвестный HTTP-метод '{метод}'. Допустимый: POST | В веб-хуках можно указывать только поддерживаемые HTTP методы. Допустимым сейчас является POST. |
| 30002 | Ошибка сохранения webhook: неизвестное действие '{действие}'. Допустимые: CREATE, UPDATE, DELETE | В веб-хуках можно указывать только доступные действия: CREATE, UPDATE, DELETE. |
| 30003 | Ошибка сохранения webhook: webhook с данным набором параметров уже существует | В веб-хуках на тройку (сущность, действие, адрес) может быть установлен только один веб-хук. |
| 30004 | Необходимы права администратора для работы с webhook | Управление веб-хуками доступно только пользователям с правами администратора. |
| 30005 | Ошибка сохранения webhook: значение поля url не является корректным адресом запроса | Значение поля url не является корректным адресом запроса. Проверьте адрес запроса на соответствие формату http, https адреса запроса. |
| 30006 | Ваш тарифный план не позволяет работать с веб-хуками | Веб-хуки доступны на всех тарифах кроме бесплатного. |
| 30007 | Нельзя создать больше '5' веб-хуков одинакового типа на одну сущность | Нельзя создать новых веб-хуков на данный тип сущности и действия сверх данного ограничения. Удалите старые веб-хуки или перенастройте на новые url. |
Коды ошибок для Валют
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 31000 | Валюту учета нельзя удалить | Валюту учета нельзя удалить. |
Коды ошибок для Договоров
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 32001 | Ошибка сохранения договора: невозможно изменить тип договора на комиссионный. По данному договору существует отгрузка, в составе позиций которой присутствует комплект | Проверьте, чтобы по данному договору не было отгрузок комплектов и попробуйте снова. |
| 32002 | Ошибка сохранения договора: невозможно изменить тип договора на комиссионный. Договор, используемый в документах с компонентами комплектов, не может быть комиссионным | Проверьте, чтобы по данному договору не было документов с компонентами комплектов и попробуйте снова. |
Коды ошибок для Печатных форм
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 33000 | Ошибка формирования печатной формы: не найден шаблон печатной формы | Шаблон, указанный при формировании печатной формы не существует. Проверьте корректность указанного шаблона для печати. |
| 33001 | Ошибка формирования печатной формы: неизвестный формат | Проверьте, что указанный формат входит в список перечисленных: xls, pdf, html, ods. |
| 33002 | Ошибка формирования печатной формы: '<текст ошибки>' | Текст ошибки указывает на проблемы, возникшие при печати документа. |
| 33003 | Ошибка формирования печатной формы: отсутствует ссылка на шаблон для печати | Для того, чтобы сгенерировать печатную форму, необходимо отправить шаблон. |
| 33004 | Ошибка формирования печатной формы: отсутствует поле count для шаблона печатной формы | При печати комплектов необходимо указывать поле count - число копий печатной формы в комплекте. |
| 33005 | Ошибка формирования печатной формы: указаны оба поля для ссылок на шаблон: template и templates. | Возможно указать только одно из полей запроса template или templates. |
| 33006 | Ошибка формирования печатной формы: поле count для шаблона печатной формы может принимать только целые значения в диапазоне от 1 до 10 | Поле count должно быть в интервале [1, 10]. |
| 33007 | Ошибка формирования печатной формы: отсутствует ссылка на юрлицо | Для того, чтобы сгенерировать печатную форму для товара, необходимо отправить ссылку на юрлицо. |
| 33008 | Ошибка формирования печатной формы: отсутствует количество ценников/термоэтикеток | Для того, чтобы сгенерировать печатную форму для товара, необходимо отправить количество. |
| 33009 | Ошибка формирования печатной формы: отсутствует тип цены | Для того, чтобы сгенерировать печатную форму для товара, необходимо отправить тип цены. |
| 33010 | Ошибка формирования печатной формы комплекта документов: для указанной сущности не было передано подходящих шаблонов печатной формы. | Чтобы напечатать комплект документов, нужно передать хотя бы 1 подходящий для данной сущности шаблон печатной формы. |
| 33011 | Ошибка формирования печатной формы комплекта документов: сущность для печати комплекта должна быть документом | Невозможно напечатать комплект документов для сущности, не являющейся документом. |
| 33012 | Печать для типа '{тип}' не поддерживается | Печать не поддерживается для данного типа. |
Коды ошибок для Публикаций
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 34000 | Публикации для типа '{тип}' не поддерживаются | Публикации доступны только для следующих типов: Заказ покупателя, Счет покупателю, Отгрузка, Заказ поставщику, Счет поставщика, Приемка, Входящий платеж, Приходный ордер, Исходящий платеж, Расходный ордер, Внутренний заказ, Перемещение, Оприходование, Списание, Счет-фактура выданный, Счет-фактура полученный, Возврат поставщику, Возврат покупателя, Выплата денег, Внесение денег, Розничный возврат, Розничная продажа, Договор, Розничная смена, Заказ на производство, Полученный отчёт комиссионера, Выданный отчёт комиссионера, Инвентаризация, Тех. Операция. |
| 34001 | Не удалось создать публикацию. Проверьте корректность шаблона. | Во время генерации документа возникла ошибка. Проверьте корректность передаваемого шаблона. |
| 34002 | Ошибка создания публикации документов: ваш тариф не позволяет создавать публикацию документов на основе пользовательского шаблона печатной формы | Ваш тарифный план не позволяет использовать при публикации документов пользовательские шабоны. |
| 34003 | Ошибка: нельзя работать с публикацией сущности так как к ней отсутствует доступ на '<чтение, запись>'. | Работа пользователя с публикациями документов возможна, если есть право на чтение и право печати сущности данного типа. |
Коды ошибок для Счет-фактур
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 35000 | Ошибка формирования счета-фактуры: передано более 1 документа-основания в коллекции | Счет-фактура может быть создан только на основании одного документа. Проверьте, что был передан один массив связанных документов с одним документом-основанием. |
| 35001 | Ошибка формирования счета-фактуры: документ уже внесен в счет-фактуру | Счет-фактура уже создан на основании переданного документа. |
Коды ошибок для Шаблонов
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 36000 | Ошибка формирования шаблона: передано более 1 документа-основания для формирования шаблона | Не удалось сформировать предзаполненную сущность из-за того что передано более 1 документа-основания. |
Коды ошибок для Задач
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 37000 | Ошибка: вы не можете работать с задачами, т.к. в вашем тарифном плане отсутствует опция CRM | Вы не можете создавать, редактировать и удалять задачи без тарифной опции CRM. |
| 37001 | Ошибка: вы не можете редактировать или удалить задачу, созданную другим сотрудником | Пользователь, не являющийся администратором, может изменять или удалять только задачи, которые создал он сам, либо менять статус готовности у задачи, на которую он назначен ответственным. |
| 38000 | Необходимы права администратора для работы с аудитом | Просмотр изменений доступен только пользователям с правами администратора. |
Коды ошибок для Пользовательских справочников
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 41000 | Ошибка: пользовательский справочник с идентификатором '{идентификатор}' не найден | Пользовательский справочник с указанным идентификатором не найден |
| 41001 | Ошибка: ваш тариф не позволяет работать с пользовательскими справочниками | Для тарифов "Бесплатный" и "Индивидуальный" не поддерживается работа с пользовательскими справочниками. |
Коды ошибок для Типов цен
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 42000 | Ошибка валидации: превышено максимальное количество типов цен | Превышено максимальное количество типов цен (100). |
| 42001 | Ошибка сохранения: нельзя удалить все типы цен | При редактировании списка типа цен необходимо указать хотя бы один. |
Коды ошибок для Сотрудников
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 43001 | Ошибка сохранения сотрудника: у изображения отсутствует контент | При передаче изображения в запросе на изменение сотрудника необходимо указывать поле content |
| 43002 | Ошибка сохранения сотрудника: невозможно преобразовать поле content в изображение | Содержимым поля content должно быть изображение закодированное в формате base64 с расширением jpg или png. |
| 43003 | Ошибка сохранения сотрудника: Недостаточно места в хранилище. | Место в хранилище, выделенное для вашей учётной записи закончилось. |
| 43004 | Ошибка сохранения сотрудника: размер изображения превышает максимально допустимый(3 мб) | Попробуйте уменьшить размер изображения. |
| 43005 | Ошибка сохранения сотрудника: у изображения отсутствует имя файла | При загрузке изображения необходимо указать непустое имя файла в поле filename. |
| 43006 | Ошибка сохранения сотрудника: неверный формат ИНН | Проверьте, чтобы формат ИНН соответствовал формату ИНН физического лица. |
Коды ошибок для Скачивания изображений
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 44000 | Метод POST не поддерживается для URL ' |
HTTP метод POST не поддерживается для запроса на скачивание изображения. |
| 44001 | Метод PUT не поддерживается для URL ' |
HTTP метод PUT не поддерживается для запроса на скачивание изображения. |
| 44002 | Метод DELETE не поддерживается для URL ' |
HTTP метод DELETE не поддерживается для запроса на скачивание изображения. |
Коды ошибок для Тарифных ограничений
| Код ошибки | Сообщение | Описание |
|---|---|---|
| 47000 | Тарифное ограничение: {описание ограничения} | Сработало тарифное ограничение для текущего тарифа. |
Сущности
Контрагент
Контрагенты
Средствами JSON API можно создавать и обновлять сведения о Контрагентах, запрашивать списки Контрагентов и сведения по отдельным Контрагентам. Счетами Контрагента и его контактными лицами можно управлять как в составе отдельного Контрагента, так и отдельно - с помощью специальных ресурсов для управления счетами и контактными лицами Контрагента. Кодом сущности для Контрагента в составе JSON API является ключевое слово counterparty. Больше о Контрагентах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке.
Поиск среди объектов Контрагента осуществляется по нескольким условиям. Если значения полей контрагента удовлетворяют хотя бы одному из условий, то контрагент будет найден.
Первое условие поиска: + По наименованию Контрагента name + По коду Контрагента code + По полному наименованию Контрагента legalTitle + По номеру дисконтной карты Контрагента discountCardNumber + По адресу электронной почты email
Второе условие поиска: + По номеру городского телефона phone
Третье условие поиска по полям из всех контактных лиц фирмы контрагента (contactpersons): + По имени контактного лица name + По почте контактного лица email
Четвертое условие поиска по полям из всех контактных лиц фирмы контрагента (contactpersons): + По номеру телефона контактного лица phone
Атрибуты сущности
- meta - Метаданные объекта
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления Контрагента
Только для чтения - name - Наименование Контрагента
Необходимое - description - Комментарий к Контрагенту
- code - Код Контрагента
- externalCode - Внешний код Контрагента
Только для чтения - archived - Добавлен ли Контрагент в архив
- created - Дата создания
- email - Адрес электронной почты
- phone - Номер городского телефона
- fax - Номер факса
- actualAddress - Фактический адрес Контрагента
- accounts - Ссылка на счета Контрагента (массив)
- companyType - Тип Контрагента.
[Юридическое лицо, Индивидуальный предприниматель, Физическое лицо]. В зависимости от значения данного поля набор выводимых реквизитов контрагента может меняться. Подробнее тут - discountCardNumber - номер дисконтной карты Контрагента
- state - Статус Контрагента в формате Метаданных
- salesAmount - Сумма продаж
Только для чтения
Поля реквизитов
- legalTitle - Полное наименование Контрагента
- legalAddress - Юридический адрес Контрагента
- inn - ИНН
- kpp - КПП
- ogrn - ОГРН
- ogrnip - ОГРНИП
- okpo - ОКПО
- certificateNumber - Номер свидетельства
- certificateDate - Дата свидетельства ___
- tags - Группы (массив)
- contactpersons - Ссылка на контактные лица фирмы Контрагента (массив)
- attributes - Коллекция доп. полей в формате Метаданных
- discounts - Массив ссылок на скидки в формате Метаданных
Только для чтения
Массив может содержать персональные и накопительные скидки. Персональная скидка выводится, если хотя бы раз изменялся процент скидки для контрагента, значение будет указано в поле personalDiscount. Накопительная скидка выводится, если для контрагента хотя бы раз устанавливалась коррекция суммы накоплений по скидке, значение будет указано в поле demandSumCorrection. Формат вывода скидок можно посмотреть в разделе Скидки. + notes - Массив ссылок на события Контрагента в формате Метаданных + priceType - Тип цены Контрагента (строка или null)
Атрибуты вложенных сущностей
Счета Контрагентов
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - Момент последнего обновления Контрагента
Только для чтения - isDefault - Является ли счёт основным счётом Контрагента
- accountNumber - Номер счёта
Необходимо - bankName - Наименование банка
- bankLocation - Адрес банка
- correspondentAccount - Корр счет
- bic - БИК
Контактные лица Контрагентов
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - Момент последнего обновления Контрагента
Только для чтения - name - ФИО контактного лица
Необходимое - description - Описание контактного лица
- externalCode - Внешний код контактного лица
- email - Адрес электронной почты контактного лица
- phone - Номер телефона контактного лица
- position - Должность контактного лица
- agent - Ссылка на Контрагента (тип Мета)
События Контрагента
- meta - Метаданные объекта
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - created - Момент создания события Контрагента
Только для чтения - description - Текст события Контрагента
Необходимое - agent - Ссылка на Контрагента (тип Мета)
Только для чтения - author - Создатель события, ссылка на сотрудника (тип Мета)
Только для чтения
Тип Контрагента
В зависимости от типа контрагента companyType в составе его объекта будут выводиться разные наборы реквизитов. Типы контрагента и соответствующие значения, которые могут быть переданы в данном поле: | Тип контрагента | Значение поля companyType | | ------------------------------ |:---------------------------| | Юридическое лицо | legal | | Индивидуальный предприниматель | entrepreneur | | Физическое лицо | individual |
Если тип контрагента Юридическое лицо, будут выведены следующие поля реквизитов:
+ legalTitle - Полное наименование Контрагента
+ legalAddress - Юридический адрес Контрагента
+ inn - ИНН
+ kpp - КПП
+ ogrn - ОГРН
+ okpo - ОКПО
Если тип контрагента Индивидуальный предприниматель, будут выведены следующие поля реквизитов:
+ legalTitle - Полное наименование Контрагента
+ legalAddress - Юридический адрес Контрагента
+ inn - ИНН
+ okpo - ОКПО
+ ogrnip - ОГРНИП
+ certificateNumber - Номер свидетельства
+ certificateDate - Дата свидетельства
Если тип контрагента Физическое лицо, будут выведены следующие поля реквизитов:
+ legalTitle - Полное наименование Контрагента
+ legalAddress - Юридический адрес Контрагента
+ inn - ИНН
О работе с доп. полями Контрагентов можно прочитать здесь
Получить список Контрагентов
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Контрагентов.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8b923-692c-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "12a8b923-692c-11e6-8a84-bae500000053",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/12747f9e-692c-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/11883c67-692c-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-08-23 15:21:09",
"name": "ООО \"Поставщик\"",
"externalCode": "aZBfWOKzj-lcq7c7IWZON3",
"archived": false,
"created": "2007-02-07 17:16:41",
"companyType": "legal",
"legalTitle": "Общество с ограниченной ответственностью \"Поставщик\"",
"legalAddress": "г.Москва, ул.Строителей, д.12",
"inn": "7736570901",
"kpp": "773601001",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8b923-692c-11e6-8a84-bae500000053/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8b923-692c-11e6-8a84-bae500000053/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8b923-692c-11e6-8a84-bae500000053/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"salesAmount": 0,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8e347-692c-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "12a8e347-692c-11e6-8a84-bae500000055",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/12747f9e-692c-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"created": "2007-02-07 17:16:41",
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/11883c67-692c-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-08-23 15:21:09",
"name": "ООО \"Покупатель\"",
"externalCode": "DTItQRbDhyl472ZqC5OWw2",
"archived": false,
"companyType": "legal",
"legalTitle": "Общество с ограниченной ответственностью \"Покупатель\"",
"legalAddress": "г.Москва, ул.Строителей, д.11",
"inn": "7736570902",
"kpp": "773601002",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8e347-692c-11e6-8a84-bae500000055/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8e347-692c-11e6-8a84-bae500000055/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8e347-692c-11e6-8a84-bae500000055/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"salesAmount": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12c9ebcf-692c-11e6-8a84-bae50000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "12c9ebcf-692c-11e6-8a84-bae50000005d",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/12747f9e-692c-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/11883c67-692c-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-08-23 15:21:09",
"name": "Розничный покупатель",
"externalCode": "lBvYwLWMiBsct7sVRrFnJ2",
"archived": false,
"created": "2007-02-07 17:16:41",
"companyType": "legal",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12c9ebcf-692c-11e6-8a84-bae50000005d/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12c9ebcf-692c-11e6-8a84-bae50000005d/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12c9ebcf-692c-11e6-8a84-bae50000005d/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"salesAmount": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/df2fdd2d-6934-11e6-8a84-bae500000049",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "df2fdd2d-6934-11e6-8a84-bae500000049",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/12747f9e-692c-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/11883c67-692c-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-08-23 16:24:08",
"name": "rtr",
"externalCode": "rRlzrdZmjql9r9dveXPE43",
"archived": false,
"created": "2007-02-07 17:16:41",
"companyType": "legal",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/df2fdd2d-6934-11e6-8a84-bae500000049/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/df2fdd2d-6934-11e6-8a84-bae500000049/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/df2fdd2d-6934-11e6-8a84-bae500000049/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"salesAmount": 0
}
]
}
Получить список всех Контрагентов. Результат: Объект JSON, включающий в себя поля:
| Поля | Описание |
|---|---|
| meta | Метаданные о выдаче |
| context | Метаданные о сотруднике, выполнившем запрос |
| rows | Массив JSON объектов, представляющих собой Контрагентов |
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Defaul: 1000 Example: 1000. Максимальное количество сущностей для извлечения. Допустимые значения 1 - 1000 |
| offset | number (optional) Defaul: 0 Example: 40. Отступ в выдаваемом списке сущностей |
| tags | string(optional) Example: рабочие. Подробнее про данный параметр можно посмотреть в разделе Фильтрация выборки с помощью параметра filter. Формат строки : string |
Создать Контрагента
Пример 1
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "ООО Радуга",
"description": "Сеть стройматериалов Радуга ЭКСПО",
"code": "rainbowCode",
"externalCode": "extRainbw",
"email": "raduga@stroi.ru",
"phone": "+7 495 331 22 33",
"fax": "1257752",
"actualAddress": "г.Москва ул Академика Миля дом 15 к 21",
"legalTitle": "Общество с ограниченой ответственностью \"Радуга\"",
"legalAddress": "г.Москва ул Авиастроителей д 93 к 12",
"inn": "125152124152",
"kpp": "12155521",
"ogrn": "1251512",
"okpo": "201355",
"tags": [
"Строители",
"Радуга",
"Ремонт"
],
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}'
Response 200. Успешный запрос. Результат - JSON представление созданного Контрагента.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "b80ea81b-7058-11e6-8a84-bae500000000",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/12747f9e-692c-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/11883c67-692c-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-09-01 18:28:22",
"name": "ООО Радуга",
"externalCode": "o7732zkki541HDkZZD1Yt3",
"archived": false,
"companyType": "legal",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
Пример 2
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "ООО Радуга"
}'
Response 200. Успешный запрос. Результат - JSON представление созданного Контрагента.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "b80ea81b-7058-11e6-8a84-bae500000000",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/12747f9e-692c-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/11883c67-692c-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-09-01 18:28:22",
"name": "ООО Радуга",
"externalCode": "o7732zkki541HDkZZD1Yt3",
"archived": false,
"created": "2007-02-07 17:16:41",
"companyType": "legal",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
}
}
Пример с дополнительными полями
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "ООО Овощ Экспресс",
"description": "Сеть доставки овощей",
"code": "ovoshexpressCode",
"externalCode": "extVagetable",
"email": "ovosh@delivery.ru",
"phone": "+7 495 662 12 23",
"fax": "1052034",
"actualAddress": "г.Москва ул Кузнечная д 331",
"legalTitle": "Общество с ограниченой ответственностью \"Овощ Экспресс\"",
"legalAddress": "г.Москва ул Достоевская д 93 к 12",
"inn": "1251521244152",
"kpp": "121555212",
"ogrn": "1251552",
"okpo": "201323",
"tags": [
"Овощи",
"Еда",
"Доставка"
],
"attributes": [
{
"id": "0d129ff5-2c8c-11e6-8a84-bae5000000f3",
"name": "Коэффициент скидки",
"type": "double",
"value": 0.75
},
{
"id": "0d12a9a5-2c8c-11e6-8a84-bae5000000f4",
"name": "Последний заключённый договор",
"type": "time",
"value": "2016-06-07 12:52:33"
},
{
"id": "0d12b1e7-2c8c-11e6-8a84-bae5000000f5",
"name": "Партнёрское юрлицо",
"type": "boolean",
"value": false
}
],
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
}
}'
Response 200. Успешный запрос. Результат - JSON представление созданного Контрагента.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/88fc07ac-2c8d-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "88fc07ac-2c8d-11e6-8a84-bae500000050",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:55:08",
"name": "ООО Овощ Экспресс",
"description": "Сеть доставки овощей",
"code": "ovoshexpressCode",
"externalCode": "extVagetable",
"archived": false,
"created": "2007-02-07 17:16:41",
"legalTitle": "Общество с ограниченой ответственностью \"Овощ Экспресс\"",
"legalAddress": "г.Москва ул Достоевская д 93 к 12",
"actualAddress": "г.Москва ул Кузнечная д 331",
"inn": "1251521244152",
"kpp": "121555212",
"ogrn": "1251552",
"okpo": "201323",
"email": "ovosh@delivery.ru",
"phone": "+7 495 662 12 23",
"fax": "1052034",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/attributes/0d129ff5-2c8c-11e6-8a84-bae5000000f3",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0d129ff5-2c8c-11e6-8a84-bae5000000f3",
"type": "double",
"name": "Коэффициент скидки",
"value": 0.75
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/attributes/0d12a9a5-2c8c-11e6-8a84-bae5000000f4",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0d12a9a5-2c8c-11e6-8a84-bae5000000f4",
"name": "Последний заключённый договор",
"type": "time",
"value": "2016-06-07 12:52:33"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/attributes/0d12b1e7-2c8c-11e6-8a84-bae5000000f5",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0d12b1e7-2c8c-11e6-8a84-bae5000000f5",
"name": "Партнёрское юрлицо",
"type": "boolean",
"value": false
}
],
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/88fc07ac-2c8d-11e6-8a84-bae500000050/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [
"доставка",
"еда",
"овощи"
],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/88fc07ac-2c8d-11e6-8a84-bae500000050/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/88fc07ac-2c8d-11e6-8a84-bae500000050/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
}
}
Описание
Контрагент создаётся на основе переданного объекта JSON, который содержит представление нового Контрагента.
Массовое создание и обновление Контрагентов
[
Массовое создание и обновление Контрагентов
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '
{
"name": "ООО Радуга",
"description": "Сеть стройматериалов Радуга ЭКСПО",
"code": "rainbowCode",
"externalCode": "extRainbw",
"email": "raduga@stroi.ru",
"phone": "+7 495 331 22 33",
"fax": "1257752",
"actualAddress": "г.Москва ул Академика Миля дом 15 к 21",
"legalTitle": "Общество с ограниченой ответственностью \"Радуга\"",
"legalAddress": "г.Москва ул Авиастроителей д 93 к 12",
"inn": "125152124152",
"kpp": "12155521",
"ogrn": "1251512",
"okpo": "201355",
"tags": [
"Строители",
"Радуга",
"Ремонт"
],
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"name": "ООО Радуга ЭКСПО",
"description": "Сеть рынков стройматериалов Радуга ЭКСПО",
"code": "raduga",
"externalCode": "extRainbow",
"email": "raduga@retail.ru",
"phone": "+7 495 162 32 23",
"fax": "1052054",
"actualAddress": "г.Москва ул Строителей д 331",
"legalTitle": "Общество с ограниченой ответственностью \"Радуга ЭКСПО\"",
"legalAddress": "г.Москва ул Чернорабочего д 93 к 12",
"inn": "1251581244152",
"kpp": "121557212",
"ogrn": "1253552",
"okpo": "201313",
"tags": [
"Строители",
"Ремонт",
"Радуга",
"Бетон",
"ЖЖОТ"
]
}
]'
Response 200. Успешный запрос. Результат - массив JSON представлений созданных и обновленных Контрагентов.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "b80ea81b-7058-11e6-8a84-bae500000000",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/12747f9e-692c-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/11883c67-692c-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-09-01 18:28:22",
"name": "ООО Радуга",
"externalCode": "o7732zkki541HDkZZD1Yt3",
"archived": false,
"companyType": "legal",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "6a9c3857-2c8b-11e6-8a84-bae500000047",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 12:13:31",
"name": "ООО Радуга ЭКСПО",
"description": "Сеть рынков стройматериалов Радуга ЭКСПО",
"code": "raduga",
"externalCode": "extRainbow",
"archived": false,
"created": "2007-02-07 17:16:41",
"legalTitle": "Общество с ограниченой ответственностью \"Радуга ЭКСПО\"",
"legalAddress": "г.Москва ул Чернорабочего д 93 к 12",
"actualAddress": "г.Москва ул Строителей д 331",
"inn": "1251581244152",
"kpp": "121557212",
"ogrn": "1253552",
"okpo": "201313",
"email": "raduga@retail.ru",
"phone": "+7 495 162 32 23",
"fax": "1052054",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [
"жжот",
"строители",
"бетон",
"ремонт",
"радуга"
],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
]
Массовое создание и обновление Контрагентов. В теле запроса нужно передать массив, содержащий JSON представления Контрагентов, которые вы хотите создать или обновить. Обновляемые Контрагентов должны содержать идентификатор в виде метаданных.
Удалить Контрагента
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b1. id Контрагента |
Запрос на удаление Контрагента с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200. Успешное удаление Контрагента.
Метаданные Контрагентов
Метаданные Контрагентов
Запрос на получение метаданных Контрагентов.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata"
-H "Authorization: Basic <Access-Token>"
Успешный запрос. Результат - JSON представление доп. полей Контрагентов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "counterparty"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "counterparty"
}
],
"tags": [
"Поставщики",
"Покупатели"
],
"createShared": false
}
Запрос на получение метаданных Контрагентов. Результат - объект JSON, включающий в себя:
| Параметр | Описание |
|---|---|
| meta | Ссылка на метаданные Контрагентов |
| attributes | Массив объектов доп. полей Контрагентов в формате Метаданных |
| states | Массив статусов Контрагентов |
| createShared | создавать новых Контрагентов с меткой "Общий" |
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 - id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
Контрагент
Получить Контрагента
Контрагент, обращение к которому происходит по значению его id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
Получить Контрагента
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Возвращает JSON представление Контрагента с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "b80ea81b-7058-11e6-8a84-bae500000000",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/12747f9e-692c-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/11883c67-692c-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-09-01 18:28:22",
"name": "ООО Радуга",
"externalCode": "o7732zkki541HDkZZD1Yt3",
"archived": false,
"created": "2007-02-07 17:16:41",
"companyType": "legal",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"salesAmount": 0,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
Изменить Контрагента
Описание
Обновляется представление Контрагента с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Контрагента, кроме тех, что
помечены Только для чтения в описании атрибутов Контрагента.
Поля, которые не были указаны в JSON запроса, не изменяются.
Поля account и contactpersons обновляются как элементы вложенных коллекций. При обновлении,
переданные элементы данных коллекций обрабатываются как "Все элементы данной коллекции" и полностью заменяют
элементы, ранее присутствовавшие в ней.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
Пример
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '
{
}'
Response 200 (application/json) Успешное обновление. Результат - JSON представление обновлённого Контрагента.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "6a9c3857-2c8b-11e6-8a84-bae500000047",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 12:13:31",
"name": "ООО Радуга ЭКСПО",
"description": "Сеть рынков стройматериалов Радуга ЭКСПО",
"code": "raduga",
"externalCode": "extRainbow",
"archived": false,
"created": "2007-02-07 17:16:41",
"legalTitle": "Общество с ограниченой ответственностью \"Радуга ЭКСПО\"",
"legalAddress": "г.Москва ул Чернорабочего д 93 к 12",
"actualAddress": "г.Москва ул Строителей д 331",
"inn": "1251581244152",
"kpp": "121557212",
"ogrn": "1253552",
"okpo": "201313",
"email": "raduga@retail.ru",
"phone": "+7 495 162 32 23",
"fax": "1052054",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"tags": [
"жжот",
"строители",
"бетон",
"ремонт",
"радуга"
],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
Пример с дополнительными полями
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '
{
"name": "ООО Овощ Экспресс",
"description": "Сеть экспресс-доставки овощей",
"code": "ovoshexpresscode",
"externalCode": "externalVagetable",
"email": "ovoshi@delivery.ru",
"phone": "+7 495 162 12 23",
"fax": "1052014",
"actualAddress": "г.Москва ул Кузнецкая д 331",
"legalTitle": "Общество с ограниченой ответственностью \"Овощ Экспресс\"",
"legalAddress": "г.Москва ул Волжская д 93 к 12",
"inn": "1251581244152",
"kpp": "121557212",
"ogrn": "1253552",
"okpo": "201313",
"tags": [
"Овощи",
"Еда",
"Доставка",
"Экспресс",
"Едовозы"
],
"contactpersons": [
{
"name": "Вася",
"description": "Овощерез Вася",
"position": "Овощерез"
},
{
"name": "Петя",
"position": "Овощевоз"
}
],
"accounts": [
{
"isDefault": true,
"accountNumber": "12512568161257981",
"bankName": "ОАО Сбербанк",
"bankLocation": "г Москва Ул Вавилова 19",
"correspondentAccount": "375632785587",
"bic": "1234532"
},
{
"accountNumber": "12512568161257982",
"bankName": "ВТБ",
"bic": "7654352"
}
],
"attributes": [
{
"id": "0d129ff5-2c8c-11e6-8a84-bae5000000f3",
"name": "Коэффициент скидки",
"type": "double",
"value": 0.35
},
{
"id": "0d12a9a5-2c8c-11e6-8a84-bae5000000f4",
"name": "Последний заключённый договор",
"type": "time",
"value": "2016-06-07 10:52:33"
},
{
"id": "0d12b1e7-2c8c-11e6-8a84-bae5000000f5",
"name": "Партнёрскоё юрлицо",
"type": "boolean",
"value": true
}
]
}'
Response 200 (application/json). Успешное обновление. Результат - JSON представление обновлённого Контрагента.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/88fc07ac-2c8d-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "88fc07ac-2c8d-11e6-8a84-bae500000050",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 12:08:25",
"name": "ООО Овощ Экспресс",
"description": "Сеть экспресс-доставки овощей",
"code": "ovoshexpresscode",
"externalCode": "externalVagetable",
"archived": false,
"created": "2007-02-07 17:16:41",
"legalTitle": "Общество с ограниченой ответственностью \"Овощ Экспресс\"",
"legalAddress": "г.Москва ул Волжская д 93 к 12",
"actualAddress": "г.Москва ул Кузнецкая д 331",
"inn": "1251581244152",
"kpp": "121557212",
"ogrn": "1253552",
"okpo": "201313",
"email": "ovoshi@delivery.ru",
"phone": "+7 495 162 12 23",
"fax": "1052014",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/attributes/0d129ff5-2c8c-11e6-8a84-bae5000000f3",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0d129ff5-2c8c-11e6-8a84-bae5000000f3",
"name": "Коэффициент скидки",
"type": "double",
"value": 0.35
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/attributes/0d12a9a5-2c8c-11e6-8a84-bae5000000f4",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0d12a9a5-2c8c-11e6-8a84-bae5000000f4",
"name": "Последний заключённый договор",
"type": "time",
"value": "2016-06-07 10:52:33"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/attributes/0d12b1e7-2c8c-11e6-8a84-bae5000000f5",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0d12b1e7-2c8c-11e6-8a84-bae5000000f5",
"name": "Партнёрское юрлицо",
"type": "boolean",
"value": true
}
],
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/88fc07ac-2c8d-11e6-8a84-bae500000050/accounts",
"type": "account",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"tags": [
"овощи",
"доставка",
"еда",
"едовозы",
"экспресс"
],
"contactpersons": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/ee15550e-2c9e-11e6-8a84-bae500000003/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/ee15550e-2c9e-11e6-8a84-bae500000003/notes",
"type": "note",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
Счета Контрагента
Получить счета Контрагента
Список счетов Контрагента с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
| limit | number (optional) Default: 1000 Example: 1000 - Максимальное количество сущностей для извлечения. Допустимые значения 1 - 1000 |
| offset | number (optional) Default: 0 Example: 40 - Отступ в выдаваемом списке сущностей. |
Получить счета Контрагента
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19/accounts"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Возвращает массив JSON представлений счетов Контрагента.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047/accounts",
"type": "account",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047/accounts/04c5d0dc-2c92-11e6-8a84-bae5000000f6",
"type": "account",
"mediaType": "application/json"
},
"id": "04c5d0dc-2c92-11e6-8a84-bae5000000f6",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"updated": "2016-06-07 12:27:13",
"isDefault": false,
"accountNumber": "125917666032321985647",
"bankName": "ВТБ",
"bankLocation": "ул Сахаровского д 153",
"correspondentAccount": "12512578256712",
"bic": "1258617"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6a9c3857-2c8b-11e6-8a84-bae500000047/accounts/6a9c43ce-2c8b-11e6-8a84-bae500000048",
"type": "account",
"mediaType": "application/json"
},
"id": "6a9c43ce-2c8b-11e6-8a84-bae500000048",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"updated": "2016-06-07 11:39:58",
"isDefault": true,
"accountNumber": "236174374372272747234743274",
"bankName": "ОАО Сбербанк",
"bankLocation": "ул Ваивлова д 19",
"correspondentAccount": "251632427568",
"bic": "125125125"
}
]
}
Счет Контрагента
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента . |
| accountId | string (required) (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Счёта. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить счет Контрагента
Получить счет Контрагент
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19/accounts/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Возвращает JSON представление счета Контрагента.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/ee15550e-2c9e-11e6-8a84-bae500000003/accounts/a6aa5466-2ca2-11e6-8a84-bae500000017",
"type": "account",
"mediaType": "application/json"
},
"id": "a6aa5466-2ca2-11e6-8a84-bae500000017",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"updated": "2016-06-07 14:26:17",
"isDefault": false,
"accountNumber": "12512568161257982",
"bankName": "ВТБ",
"bic": "7654352"
}
Контактные лица Контрагента
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Список контактных лиц
Список контактных лиц
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19/contactpersons"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Возвращает массив JSON представлений контактных лиц Контрагента.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/contactpersons",
"type": "contactperson",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/contactpersons/43e39375-7059-11e6-8a84-bae5000000cb",
"type": "contactperson",
"mediaType": "application/json"
},
"id": "43e39375-7059-11e6-8a84-bae5000000cb",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"updated": "2016-09-01 18:32:17",
"name": "Адвокатов Петр Сергеевич",
"description": "Адвокат",
"externalCode": "asI0ncJch5jkgxxlCQKiH1",
"email": "advopetr@mail.ru",
"phone": "87127418",
"position": "Адвокат",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/contactpersons/308142fc-7059-11e6-8a84-bae5000000c6",
"type": "contactperson",
"mediaType": "application/json"
},
"id": "308142fc-7059-11e6-8a84-bae5000000c6",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"updated": "2016-09-01 18:31:44",
"name": "Travolta Jehn",
"description": "Траволта на связи",
"externalCode": "9QZNh3dbiLu1-V9bmmLKu0",
"email": "travolta@mail.ru",
"phone": "125815120",
"position": "Секретарь",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000/contactpersons/13af74bf-7059-11e6-8a84-bae5000000c3",
"type": "contactperson",
"mediaType": "application/json"
},
"id": "13af74bf-7059-11e6-8a84-bae5000000c3",
"accountId": "1185513e-692c-11e6-8a84-bae500000001",
"updated": "2016-09-01 18:30:56",
"name": "Панин Алексей Олегович",
"description": "Бухгалтерия",
"externalCode": "Gaizui5siLqoUbZ3jpE2I2",
"email": "mail@mail.rq",
"phone": "12412512512",
"position": "Бухгалтер",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}
]
}
Создать контактное лицо
Создать контактное лицо Контрагента с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
Пример запроса на создание контактного лица Контрагента.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19/contactpersons"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Пётр",
"code": "Petya the deliverer",
"externalCode": "-odJxBw7i06O0GhSc28S90",
"email": "petr@ovoshy.com",
"phone": "+777 666 228",
"position": "овощедоставщик"
}'
Response 200 (application/json). Успешное создание.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19/contactpersons/ceba215c-d5cb-11e7-0532-9eed00000005",
"type": "contactperson",
"mediaType": "application/json"
},
"id": "ceba215c-d5cb-11e7-0532-9eed00000005",
"accountId": "eb9ac8c0-d511-11e7-0532-9eed00000001",
"updated": "2017-11-30 15:41:38",
"name": "Пётр",
"code": "Petya the deliverer",
"externalCode": "-odJxBw7i06O0GhSc28S90",
"email": "petr@ovoshy.com",
"phone": "+777 666 228",
"position": "овощедоставщик",
"agent": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#company/edit?id=7944ef04-f831-11e5-7a69-971500188b19"
}
}
}
]
Контактное лицо
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
| contactpersonId | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id контактного лица. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить контактное лицо
Получить контактное лицо
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19/contactpersons/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Возвращает JSON представление отдельного контактного лица Контрагента.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/ee15550e-2c9e-11e6-8a84-bae500000003/contactpersons/94433ed3-2c9f-11e6-8a84-bae500000010",
"type": "contactperson",
"mediaType": "application/json"
},
"id": "94433ed3-2c9f-11e6-8a84-bae500000010",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"updated": "2016-06-07 14:04:17",
"name": "Пётр",
"code": "Petya the deliverer",
"externalCode": "-odJxBw7i06O0GhSc28S90",
"email": "petr@ovoshy.com",
"phone": "+777 666 228",
"position": "овощедоставщик",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/ee15550e-2c9e-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}
Изменить контактное лицо
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
| contactpersonId | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id контактного лица. |
Описание
Обновить контактное лицо Контрагента с указанным id.
Обновляются все поля, указанные в JSON объекте запроса, кроме
помеченных Только для чтения в описании атрибутов контактных лиц Контрагента.
Поля, которые не были указаны в JSON запроса, не изменяются.
Пример запроса на обновление контактного лица Контрагента.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19/contactpersons/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Пётр",
"code": "Petya the deliverer",
"email": "petr@ovoshy.com",
"phone": "+777 666 228",
"position": "овощедоставщик"
}'
Response 200 (application/json). Успешное обновление.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/ee15550e-2c9e-11e6-8a84-bae500000003/contactpersons/94433ed3-2c9f-11e6-8a84-bae500000010",
"type": "contactperson",
"mediaType": "application/json"
},
"id": "94433ed3-2c9f-11e6-8a84-bae500000010",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"updated": "2016-06-07 14:04:17",
"name": "Пётр",
"code": "Petya the deliverer",
"externalCode": "-odJxBw7i06O0GhSc28S90",
"email": "petr@ovoshy.com",
"phone": "+777 666 228",
"position": "овощедоставщик",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/ee15550e-2c9e-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}
События Контрагента
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 67e5a691-3c9c-11e7-8af5-581e00000056 - id Контрагента. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Список событий
Список событи
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056/notes"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Успешный запрос.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056/notes",
"type": "note",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056/notes/7e391b16-3efd-11e7-8af5-581e0000009d",
"type": "note",
"mediaType": "application/json"
},
"id": "7e391b16-3efd-11e7-8af5-581e0000009d",
"accountId": "b127966a-3efa-11e7-8af5-581e00000001",
"created": "2017-05-22 17:46:52",
"description": "второе событие",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b1876a85-3efa-11e7-8af5-581e0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056/notes/7b919056-3efd-11e7-8af5-581e0000009a",
"type": "note",
"mediaType": "application/json"
},
"id": "7b919056-3efd-11e7-8af5-581e0000009a",
"accountId": "b127966a-3efa-11e7-8af5-581e00000001",
"created": "2017-05-22 17:46:47",
"description": "первое событие",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b1876a85-3efa-11e7-8af5-581e0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
}
]
}
Добавить событие
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 67e5a691-3c9c-11e7-8af5-581e00000056 - id Контрагента. |
Запрос на добавление нового события.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056/notes"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"description": "текст"
}'
Response 200 (application/json). Успешный запрос. Результат - JSON представление добавленного события.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056/notes/50b318cb-3cb0-11e7-8af5-581e00000007",
"type": "note",
"mediaType": "application/json"
},
"id": "50b318cb-3cb0-11e7-8af5-581e00000007",
"accountId": "674f0d4f-3c9c-11e7-8af5-581e00000001",
"created": "2017-05-19 19:29:22",
"description": "текст",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/67b86071-3c9c-11e7-8af5-581e0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
}
]
Событие
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
| noteId | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id события. |
Получить событие
Получить событие
curl -X GET
"GET https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19/notes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Возвращает JSON представление отдельного события Контрагента.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056/notes/50b318cb-3cb0-11e7-8af5-581e00000007",
"type": "note",
"mediaType": "application/json"
},
"id": "50b318cb-3cb0-11e7-8af5-581e00000007",
"accountId": "674f0d4f-3c9c-11e7-8af5-581e00000001",
"created": "2017-05-19 19:29:22",
"description": "текст",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/67b86071-3c9c-11e7-8af5-581e0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
}
Изменить событие
Описание
Обновить событие Контрагента с указанным id.
Обновляются все поля, указанные в JSON объекте запроса, кроме
помеченных Только для чтения в описании атрибутов событий Контрагента.
Поля, которые не были указаны в JSON запроса, не изменяются.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
| noteId | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id события. |
Пример запроса на обновление события Контрагента.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/7944ef04-f831-11e5-7a69-971500188b19/notes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"description": "измененный текст"
}'
Response 200 (application/json). Успешное обновление.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056/notes/50b318cb-3cb0-11e7-8af5-581e00000007",
"type": "note",
"mediaType": "application/json"
},
"id": "50b318cb-3cb0-11e7-8af5-581e00000007",
"accountId": "674f0d4f-3c9c-11e7-8af5-581e00000001",
"created": "2017-05-19 19:29:22",
"description": "измененный текст",
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/67b86071-3c9c-11e7-8af5-581e0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
}
Удалить событие
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Контрагента. |
| noteId | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id события. |
Запрос на удаление события с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/67e5a691-3c9c-11e7-8af5-581e00000056/notes/50b318cb-3cb0-11e7-8af5-581e00000007"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Успешное удаление События.
Ассортимент
Ассортимент
Сущность assortment представляет собой список всех товаров, услуг, комплектов, серий и модификаций с полями stock,
reserve, inTransit, quantity, показывающими остаток, резерв, ожидание и доступно каждой из сущностей (для комплектов не выводятся поля остатков и резерва).
Данные поля могут быть рассчитаны в зависимости от даты и склада с использованием параметров запроса stockmoment и stockstore.
Особенность данной сущности заключается в наличии специального параметра search в фильтре по нескольким полям с помощью параметра filter.
Используя этот параметр можно произвести контекстный поиск по объектам, выводимым в ассортименте.
Чтобы это осуществить, нужно использовать фильтр выборки по нескольким полям,
указав в качестве одного из полей поле search и условие для этого поля - равенство поисковой строке.
+ Пример (не URL encoded): filter=search=some_random_string.
Поиск filter=search=some_random_string среди объектов ассортимента на соответствие поисковой строке будет осуществлён по следующим полям:
+ по наименованию элемента Ассортимента name
+ по имени модификации name
+ по коду code
+ по коду модификации code
+ по артикулу article
+ по штрихкоду barcode
+ по штрихкоду модификации barcode
Также по данной сущности можно осуществлять контекстный поиск с помощью специального параметра search (используется без filter). Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск search=some_random_string среди объектов ассортимента на соответствие поисковой строке будет осуществлён по следующим полям:
+ по наименованию элемента ассортимента name
+ по описанию description
Также ассортимент можно запросить с использованием ссылочного фильтра по группе товаров productFolder.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| stockstore | string (optional) Ссылка на склад, по которому нужно получить остатки. Формат - URI. . |
| stockmoment | string (optional) Момент времени, на который нужно вывести остатки. Формат строки: YYYY-MM-DD HH:MM:SS . |
| scope | string (optional) Параметр фильтрации по типу объектов. Принимает одно из значений: product - будут выведены только товары, variant - будут выведены товары и модификации, consignment - будут выведены все сущности (аналогично отсутствию параметра) |
| stockmode | string (optional) Вид Остатка. Параметр совместим только с параметрами:limit,offset,stockstore,stockmoment. Если указаны параметры отличные от совместимых в ответ вернется ошибка с кодом 1069. Допустимые значения all, positiveOnly, negativeOnly, empty, nonEmpty. |
По умолчанию параметр stockmode имеет значение all. Если вы хотите увидеть объекты с нулевым или отрицательным остатком нужно указать соответствующее значение данного параметра.
Получить Ассортимент
Запрос на получение всех товаров, услуг, комплектов, модификаций и серий в виде списка.
curl -X GET
"GET https://online.moysklad.ru/api/remap/1.2/entity/assortment"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json). Успешный запрос. Результат - JSON представление списка всех товаров, услуг, модификация и серий.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata",
"type": "assortment",
"mediaType": "application/json",
"size": 7,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/35427052-36e7-11e7-8a7f-40d0000000d1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "35427052-36e7-11e7-8a7f-40d0000000d1",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/105a788e-36e7-11e7-8a7f-40d000000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/103cca6f-36e7-11e7-8a7f-40d000000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-05-12 10:47:11",
"name": "product",
"code": "00001",
"externalCode": "LsAGeHdbgyQ3oSlTzZUvH0",
"archived": false,
"pathName": "",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"image": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/28ca8201-36e7-11e7-8a7f-40d0000000cd",
"mediaType": "application/octet-stream"
},
"title": "product_image",
"filename": "product_image.png",
"size": 64211,
"updated": "2017-05-12 10:46:50",
"miniature": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/28ca8201-36e7-11e7-8a7f-40d0000000cd?miniature=true",
"mediaType": "image/png"
},
"tiny": {
"href": "https://online.moysklad.ru/app/download/28ca6fbb-36e7-11e7-8a7f-40d0000000cc.png",
"mediaType": "image/png"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 1500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1076cf8b-36e7-11e7-8a7f-40d000000093",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"buyPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "100000000",
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean13": "2000000000015"
}
],
"variantsCount": 0,
"isSerialTrackable": false,
"stock": 0,
"reserve": 0,
"inTransit": 0,
"quantity": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/c66f4b17-36e7-11e7-8a7f-40d000000113",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata",
"type": "consignment",
"mediaType": "application/json"
},
"id": "c66f4b17-36e7-11e7-8a7f-40d000000113",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"updated": "2017-05-12 10:51:15",
"name": "product / consignment",
"code": "1012",
"externalCode": "g9BOLNRZglk9NMOHxcrVV0",
"label": "consignment",
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/35427052-36e7-11e7-8a7f-40d0000000d1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"stock": 0,
"reserve": 0,
"inTransit": 0,
"quantity": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/437f2d67-36e7-11e7-8a7f-40d0000000df",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "437f2d67-36e7-11e7-8a7f-40d0000000df",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/105a788e-36e7-11e7-8a7f-40d000000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/103cca6f-36e7-11e7-8a7f-40d000000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-05-12 10:47:35",
"name": "service",
"code": "00002",
"externalCode": "DDBfxV4djLuOlbr80-I1A0",
"archived": false,
"pathName": "",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 1500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bundle/4f75d130-36e7-11e7-8a7f-40d0000000ef",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json"
},
"id": "4f75d130-36e7-11e7-8a7f-40d0000000ef",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/105a788e-36e7-11e7-8a7f-40d000000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/103cca6f-36e7-11e7-8a7f-40d000000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-05-12 10:47:55",
"name": "bundle",
"code": "00003",
"externalCode": "ndWrlXCZjm9uSyLk57KOD0",
"archived": false,
"pathName": "",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 0,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"article": "50000000",
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean13": "2000000000046"
}
],
"components": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bundle/4f75d130-36e7-11e7-8a7f-40d0000000ef/components",
"type": "bundlecomponent",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/6830a346-36e7-11e7-8a7f-40d0000000f8",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "6830a346-36e7-11e7-8a7f-40d0000000f8",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/105a788e-36e7-11e7-8a7f-40d000000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/103cca6f-36e7-11e7-8a7f-40d000000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-05-12 10:48:37",
"name": "product2",
"code": "00004",
"externalCode": "bxviUUtwg4C6y4RdOc2GS3",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 1800,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "2000000000000",
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean13": "2000000000053"
}
],
"variantsCount": 2,
"isSerialTrackable": false,
"stock": 0,
"reserve": 0,
"inTransit": 0,
"quantity": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/68379863-36e7-11e7-8a7f-40d0000000fd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"id": "68379863-36e7-11e7-8a7f-40d0000000fd",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"updated": "2017-05-12 10:48:37",
"name": "product2 (blue)",
"code": "00002",
"externalCode": "BrmW28jLhRMI-jOPUdfWW0",
"archived": false,
"characteristics": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/682beecc-36e7-11e7-8a7f-40d0000000f5",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "682beecc-36e7-11e7-8a7f-40d0000000f5",
"name": "color",
"value": "blue"
}
],
"salePrices": [
{
"value": 1800,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"barcodes": [
{
"ean13": "2000000000060"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/6830a346-36e7-11e7-8a7f-40d0000000f8",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"stock": 0,
"reserve": 0,
"inTransit": 0,
"quantity": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/6839f0fa-36e7-11e7-8a7f-40d000000101",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"id": "6839f0fa-36e7-11e7-8a7f-40d000000101",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"updated": "2017-05-12 10:48:37",
"name": "product2 (red)",
"code": "00003",
"externalCode": "i0u4rktiiVX6BWL60IVkJ1",
"archived": false,
"characteristics": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/682beecc-36e7-11e7-8a7f-40d0000000f5",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "682beecc-36e7-11e7-8a7f-40d0000000f5",
"name": "color",
"value": "red"
}
],
"salePrices": [
{
"value": 1800,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"barcodes": [
{
"ean13": "2000000000077"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/6830a346-36e7-11e7-8a7f-40d0000000f8",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"stock": 0,
"reserve": 0,
"inTransit": 0,
"quantity": 0
}
]
}
Валюта
Средствами JSON API можно запрашивать списки валют и сведения по отдельным валютам, а также создавать новые и обновлять сведения по уже существующим валютам. Кодом сущности для валют в составе JSON API является ключевое слово currency. Больше о валютах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по
этой ссылке.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов валют на соответствие поисковой строке будет осуществлён по следующим полям: + по краткому наименованию Валюты name
Атрибуты Сущности
| Атрибут | Описание |
|---|---|
| meta | Метаданные объекта |
| id | ID в формате UUID Только для чтения |
| name | Краткое наименование Валюты Необходимое |
| fullName | Полное наименование Валюты |
| code | Цифровой код Валюты Необходимое |
| isoCode | Буквенный код Валюты Необходимое |
| rate | Курс Валюты |
| multiplicity | Кратность курса Валюты |
| indirect | Признак обратного курса Валюты |
| rateUpdateType | Способ обновления курса Валюты Только для чтения |
| majorUnit | Формы единиц целой части Валюты |
| minorUnit | Формы единиц дробной части Валюты |
| archived | Добавлена ли Валюта в архив |
| system | Основана ли валюта на валюте из системного справочника Только для чтения |
| default | Является ли валюта валютой учета Только для чтения |
Формы единиц
Поля majorUnit и minorUnit содержат в себе следующие атрибуты:
| Атрибут | Описание |
|---|---|
| gender | Грамматический род единицы валюты (допустимые значения masculine - мужской, feminine - женский) |
| s1 | Форма единицы, используемая при числительном 1 |
| s2 | Форма единицы, используемая при числительном 2 |
| s5 | Форма единицы, используемая при числительном 5 |
В JSON API валюты в основном представлены в составе сущностей в формате Метаданные. Для того, чтобы раскрыть их в составе другого объекта нужно воспользоваться параметром expand
Получить Валюты
Результат успешного запроса - JSON представление списка валют с перечисленными полями:
| Поле | Описание |
|---|---|
| meta | Метаданные о выдаче |
| context | Метаданные о сотруднике, выполнившем запрос |
| rows | Массив JSON объектов, представляющих собой валюты |
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение списка всех валют на данной учётной записи.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/currency/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Валют.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#currency/edit?id=6314188d-2c7f-11e6-8a84-bae500000055"
},
"id": "6314188d-2c7f-11e6-8a84-bae500000055",
"system": false,
"name": "руб",
"fullName": "Рубль",
"rate": 1.0,
"multiplicity": 1,
"indirect": false,
"rateUpdateType": "manual",
"code": "643",
"isoCode": "RUB",
"majorUnit": {
"gender": "masculine",
"s1": "рубль",
"s2": "рубля",
"s5": "рублей"
},
"minorUnit": {
"gender": "feminine",
"s1": "копейка",
"s2": "копейки",
"s5": "копеек"
},
"archived": false,
"default": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/dc5f76ae-2c89-11e6-8a84-bae50000003f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#currency/edit?id=dc5f76ae-2c89-11e6-8a84-bae50000003f"
},
"id": "dc5f76ae-2c89-11e6-8a84-bae50000003f",
"system": true,
"name": "доллар",
"fullName": "Доллар США",
"rate": 63.0,
"multiplicity": 1,
"indirect": false,
"rateUpdateType": "manual",
"code": "840",
"isoCode": "USD",
"majorUnit": {
"gender": "masculine",
"s1": "доллар",
"s2": "доллара",
"s5": "долларов"
},
"minorUnit": {
"gender": "masculine",
"s1": "цент",
"s2": "цента",
"s5": "центов"
},
"archived": false,
"default": false
}
]
}
Создать новую Валюту
Обязательные поля для создание валюты: name, code и isoCode. В теле запроса нельзя указать курс валюты (rate) равным нулю.
Запрос на создание новой валюты.
curl -X POST
https://online.moysklad.ru/api/remap/1.2/entity/currency/
-H "Authorization: Basic <Access-Token>"
-H 'Content-Type: application/json'
-d '{
"name": "доллар",
"rate": 63,
"code" : "840",
"isoCode": "USD"
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Валюты.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/dc5f76ae-2c89-11e6-8a84-bae50000003f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#currency/edit?id=dc5f76ae-2c89-11e6-8a84-bae50000003f"
},
"id": "dc5f76ae-2c89-11e6-8a84-bae50000003f",
"system": false,
"name": "доллар",
"rate": 63.0,
"multiplicity": 1,
"indirect": false,
"rateUpdateType": "manual",
"code": "840",
"isoCode": "USD",
"majorUnit": {
"gender": "masculine"
},
"minorUnit": {
"gender": "masculine"
},
"archived": false,
"default": false
}
Массовое создание и обновление Валют
Массовое создание и обновление Валют. В теле запроса нужно передать массив, содержащий JSON представления Валют, которые вы хотите создать или обновить. Обновляемые Валюты должны содержать идентификатор в виде метаданных.
Массовое создание и обновление Валют
curl -X POST
https://online.moysklad.ru/api/remap/1.2/entity/currency/
-H "Authorization: Basic <Access-Token>"
-H 'Content-Type: application/json'
-d '[
{
"name": "доллар",
"rate": 63,
"code" : "840",
"isoCode": "USD"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/dc5f76ae-2c89-11e6-8a84-bae50000003f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
},
"name": "долл",
"rate": 66,
"code" : "dollarusd",
"isoCode": "USD"
}
]
'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Валют.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/dc5f76ae-2c89-11e6-8a84-bae50000003f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#currency/edit?id=dc5f76ae-2c89-11e6-8a84-bae50000003f"
},
"id": "dc5f76ae-2c89-11e6-8a84-bae50000003f",
"system": false,
"name": "доллар",
"rate": 63.0,
"multiplicity": 1,
"indirect": false,
"rateUpdateType": "manual",
"code": "840",
"isoCode": "USD",
"majorUnit": {
"gender": "masculine"
},
"minorUnit": {
"gender": "masculine"
},
"archived": false,
"default": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/dc5f76ae-2c89-11e6-8a84-bae50000003f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#currency/edit?id=dc5f76ae-2c89-11e6-8a84-bae50000003f"
},
"id": "dc5f76ae-2c89-11e6-8a84-bae50000003f",
"system": false,
"name": "долл",
"rate": 66.0,
"multiplicity": 1,
"indirect": false,
"rateUpdateType": "manual",
"code": "dollarusd",
"isoCode": "USD",
"majorUnit": {
"gender": "masculine"
},
"minorUnit": {
"gender": "masculine"
},
"archived": false,
"default": false
}
]
Удалить Валюту
Запрос на удаление Валюты с указанным id. Валюту учета удалить нельзя.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Валюты |
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/currency/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Валюты.
Валюта
Получить Валюту
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Валюты |
Получить Валюту
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/currency/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление запрошенной Валюты.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#currency/edit?id=6314188d-2c7f-11e6-8a84-bae500000055"
},
"id": "6314188d-2c7f-11e6-8a84-bae500000055",
"system": false,
"name": "руб",
"fullName": "Рубль",
"rate": 1.0,
"multiplicity": 1,
"indirect": false,
"rateUpdateType": "manual",
"code": "643",
"isoCode": "RUB",
"majorUnit": {
"gender": "masculine",
"s1": "рубль",
"s2": "рубля",
"s5": "рублей"
},
"minorUnit": {
"gender": "feminine",
"s1": "копейка",
"s2": "копейки",
"s5": "копеек"
},
"archived": false,
"default": true
}
Изменить Валюту
Запрос на обновление существующей валюты. В теле запроса нельзя указать курс валюты (rate) равным нулю, а также пустые поля name, code, isoCode. Нельзя изменять значения полей name, fullName, code, isoCode, majorUnit, minorUnit для валют, основанных на системном справочнике валют. Нельзя изменять курс валюты учета. Нельзя изменить курс валюты с автоматическим обновлением.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 - id Валюты |
Изменить Валюту
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/currency/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-d '{
"name": "долл",
"rate": 66,
"code" : "dollarusd",
"isoCode": "USD"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Валюты.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/dc5f76ae-2c89-11e6-8a84-bae50000003f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#currency/edit?id=dc5f76ae-2c89-11e6-8a84-bae50000003f"
},
"id": "dc5f76ae-2c89-11e6-8a84-bae50000003f",
"system": false,
"name": "долл",
"rate": 66.0,
"multiplicity": 1,
"indirect": false,
"rateUpdateType": "manual",
"code": "dollarusd",
"isoCode": "USD",
"majorUnit": {
"gender": "masculine"
},
"minorUnit": {
"gender": "masculine"
},
"archived": false,
"default": false
}
Товар
Товары
Средствами JSON API можно создавать и обновлять сведения о Товарах, запрашивать списки Товаров и сведения по отдельным Товарам. Упаковками Товаров можно управлять отдельно - с помощью специальных ресурсов. Кодом сущности для Товара в составе JSON API является ключевое слово product. Больше о Товарах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки в разделе
Товары и склад.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке.
Поиск среди объектов товаров на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию товара (name) + по коду товара (code) + по артикулу (article)
Атрибуты сущности
- meta - Метаданные объекта
- id - ID Товара в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - name - Наименование Товара
Необходимое - description - Описание Товара
- code - Код Товара
- externalCode - Внешний код Товара
- archived - Отметка о том, добавлен ли Товар в архив
- pathName - Наименование группы, в которую входит Товар
Только для чтения - vat - НДС %
- effectiveVat - Реальный НДС %
Только для чтения - productFolder - Ссылка на группу Товаров в формате Метаданных
- uom - Ссылка на единицы измерения в формате Метаданных
- image - Изображение Товара
- minPrice - Минимальная цена
- buyPrice - Закупочная цена
- salePrices - Цены продажи
- supplier - Ссылка на контрагента-поставщика в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
- country - Ссылка на страну в формате Метаданных
- article - Артикул
- weighed - Весовой товар
- tobacco - Табачная продукция. Не может быть указан вместе с alcoholic, weighed и isSerialTrackable
- weight - Вес
- volume - Объём
- packs - Упаковки Товара
- barcodes - Массив штрихкодов товара
- alcoholic - Объект, содержащий поля алкогольной продукции.
- excise - Содержит акцизную марку
- type - Код вида продукции
- strength - Крепость
- volume - Объём тары
- variantsCount - Количество модификаций у данного товара
Только для чтения - minimumBalance - Неснижаемый остаток
- isSerialTrackable - Учет по серийным номерам. Не может быть указан вместе с alcoholic и weighed
- things - Серийные номера
Только для чтения
Атрибут pathName сам по себе является атрибутом только для чтения, однако его можно изменить с помощью обновления атрибута productFolder.
Атрибуты вложенных сущностей
Упаковки Товара:
- id - ID в формате UUID
Только для чтения - uom - Ссылка на единицы измерения в формате Метаданных
Необходимое - quantity - Количество Товаров в упаковке данного вида
НеобходимоеВ версии API 1.2 был удалён отдельный ресурс для работы с упаковками товаров. Теперь упаковки - вложенная коллекция. Для того, чтобы создать новую упаковку для данного товара, нужно в запросе на обновление товара указать её как элемент поля packs, а в её составе указать ссылку в формате meta на единицу измерения и количество товаров в упаковке. Нельзя указать ссылку на единицу измерения "Штуки", иначе возникнет ошибка. При обновлении, переданная коллекция упаковок полностью заменяет имеющуюся до этого коллекцию упаковок.
Метаданные Товаров
Метаданные Товаров содержат информацию о дополнительных полях.
Посмотреть все созданные в основном интерфейсе доп. поля Товаров, а также все типы цен можно с помощью запроса на получение метаданных Товаров. Ответ - объект, со следующей структурой: + meta - Метаданные + attributes - коллекция всех существующих доп. полей Товаров в формате Метаданных + createShared - создавать новые Товары с меткой "Общий"
Структуры объектов отдельных коллекций:
Штрих коды:
При создании штрихкода требуется описать объект с полем, являющимся форматом представления штрихкода в нижнем регистре, со строковым значением самого штрихкода. Наименование полей отдельного объекта, представляющего штрихкод:
- ean13 - штрихкод в формате EAN13, если требуется создать штрихкод в формате EAN13
- ean8 - штрихкод в формате EAN8, если требуется создать штрихкод в формате EAN8
- code128 - штрихкод в формате Code128, если требуется создать штрихкод в формате Code128
О работе с доп. полями Товаров можно прочитать здесь
Поставщик Товара:
- meta - Метаданные, содержащие ссылку на поставщика. Тип поставщика - Контрагент. Описание сущности Контрагент вы можете посмотреть здесь
Цены продажи
- value - Значение цены
- currency - Ссылка на валюту в формате Метаданных
- priceType - Тип цены
Закупочная цена
- value - Значение цены
- currency - Ссылка на валюту в формате Метаданных
Минимальная цена
- value - Значение цены
- currency - Ссылка на валюту в формате Метаданных
Изображение: структура и загрузка.
Структура поля image, которое вы получите при запросе товара с изображением: + meta - Метаданные об изображении + title - Название изображения + filename - Имя файла + size - Размер файла в байтах + updated - Дата последнего изменения + miniature - Ссылка на миниатюру изображения в формате Метаданных + tiny - Ссылка на уменьшенное изображение в формате Метаданных
Загрузка
Для загрузки изображения нужно в теле запроса на создание или обновление товара указать поле image со следующими атрибутами: + filename - имя файла с расширением. Например - "банан.png" + content - Изображение, закодированное в формате Base64.
Если в запросе на обновление не будет полей filename и content, то весь объект image, если он присутствует в Body, будет проигнорирован, т.к. сервер посчитает, что его обновление не требуется.
Группа Товара
- meta - Метаданные, содержащие ссылку на группу Товара. Описание сущности Группа вы можете посмотреть здесь Обновление этого атрибута также обновит атрибут pathName.
Весовой товар
- weighed - Поле, показывающее является ли товар весовым. Если его значение false - поле не отображается. Если в основном интерфейсе у товара стоит отметка об учёте его по серийным номерам, выставить значение данного поля на true невозможно.
Особенности фильтрации поля archived
Если одновременно осуществляется фильтрация по полям id и archived, то фильтрация по полю archived не учитывается.
Получить список Товаров
Запрос на получение всех Товаров для данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Товары.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить список Товаров
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/product"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Товаров.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/26b36824-2c83-11e6-8a84-bae50000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "26b36824-2c83-11e6-8a84-bae50000001b",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 10:40:48",
"name": "Тыква",
"description": "Тыква, Германия",
"code": "pumpkin1",
"externalCode": "456pumpkin",
"archived": false,
"pathName": "",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 3353,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 3253,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313d1e7-2c7f-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "string",
"value": "фермерское хозяйство \"Петрович\""
}
],
"buyPrice": {
"value": 54,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "Ar23",
"weight": 200,
"volume": 300,
"variantsCount": 0,
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/d950551c-2c7f-11e6-8a84-bae50000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "d950551c-2c7f-11e6-8a84-bae50000000b",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 10:45:16",
"name": "Бананы",
"description": "Бананы, Африка",
"code": "one1",
"externalCode": "456",
"archived": false,
"pathName": "",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 346347237000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313d1e7-2c7f-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": false
}
],
"buyPrice": {
"value": 23553000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "Ar23",
"weight": 200,
"volume": 300,
"packs": [
{
"id": "c6bdee6f-2c83-11e6-8a84-bae5000000a4",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6b91d63-2c83-11e6-8a84-bae5000000a1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 35
},
{
"id": "c6bdf693-2c83-11e6-8a84-bae5000000a5",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 2000
}
],
"variantsCount": 0,
"isSerialTrackable": true,
"things": [
"F564X056",
"F564X057"
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
]
}
]
}
Создать Товар
Создать новый Товар.
Описание
Товар создаётся на основе переданного объекта JSON,
который содержит представление нового Товара.
Результат - JSON представление созданного Товара. Для создания нового Товара,
необходимо и достаточно указать в переданном объекте не пустое поле name.
Если вы хотите создать алкогольный товар, то в теле запроса, нужно передать
объект alcoholic, у которого как минимум одна из характеристик:
+ excise - Содержит акцизную марку
+ type - Код вида продукции
+ strength - Крепость
+ volume - Объём тары
Будет передана с значением. Иначе, при передаче пустого объекта alcoholic, он будет проигнорирован, и товар создастся без пометки "Алкогольная продукция".
При создании Товара с указанным массивом штрихкодов для каждого штрихкода требуется указать к какому типу относится штрихкод. Например, чтобы создать штрихкод с типом Code 128, в массив штрихкодов должен быть добавлен JSON-объект с полем code128 со значением штрихкода.
Пример наиболее полного по количеству полей запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/product"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Бананы",
"code": "one1",
"externalCode": "456",
"description": "Бананы, Африка",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/2b5095a4-296b-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 23553000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 346347237000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"article": "Ar23",
"weight": 200,
"volume": 300,
"packs": [
{
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/2ec1170c-3f69-4409-87bb-c68e0011b275",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 2
}
],
"isSerialTrackable": false,
"tobacco": false
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Товара.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/a355f431-29a1-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "a355f431-29a1-11e6-8a84-bae500000009",
"accountId": "2aa3f5df-296b-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-03 18:41:28",
"name": "Бананы",
"description": "Бананы, Африка",
"code": "one1",
"externalCode": "456",
"archived": false,
"pathName": "",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 346347237000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/2b5095a4-296b-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"buyPrice": {
"value": 23553000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "Ar23",
"weight": 200,
"volume": 300,
"packs": [
{
"id": "a97af44b-8b46-11e8-56c0-00080000000d",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/2ec1170c-3f69-4409-87bb-c68e0011b275",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 2
}
],
"isSerialTrackable": false,
"tobacco": false
}
Пример запроса на создание Товара с единственным необходимым полем.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/product"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Мандарины"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Товара.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/04996e84-29a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "04996e84-29a1-11e6-8a84-bae500000002",
"accountId": "2aa3f5df-296b-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"salePrices": [
{
"value": 346347237000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"updated": "2016-06-03 18:37:02",
"name": "Мандарины",
"code": "00003",
"externalCode": "Cf0ehavIglre6sMX-J2rR2",
"archived": false,
"pathName": "",
"weight": 0,
"volume": 0,
"isSerialTrackable": false
}
Пример запроса на создание Товара с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/product"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Тыква",
"code": "pumpkin1",
"externalCode": "456pumpkin",
"description": "Тыква, Германия",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313d1e7-2c7f-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 54,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 3353,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 3253,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"article": "Ar23",
"weight": 200,
"volume": 300,
"attributes": [
{
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"value": true
},
{
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"value": "фермерское хозяйство \"Петрович\" "
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0f1e750e-e1b2-11e7-9464-e4de00000003",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0f1e750e-e1b2-11e7-9464-e4de00000003",
"name": "not strange attribute name",
"type": "file",
"file": {
"filename": "filename",
"content": "5cYwMpOmNk5kSVr4YgZGKtXJb/7KpHVLDUawyZrD5Nf0WDhB7mS1I77VcAMqYQ8DkP/1wDLhb0X6b2JO4pdpKA=="
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Товара.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/26b36824-2c83-11e6-8a84-bae50000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "26b36824-2c83-11e6-8a84-bae50000001b",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 10:40:48",
"name": "Тыква",
"description": "Тыква, Германия",
"code": "pumpkin1",
"externalCode": "456pumpkin",
"archived": false,
"pathName": "",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 3353,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 3253,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313d1e7-2c7f-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "string",
"value": "фермерское хозяйство \"Петрович\""
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0f1e750e-e1b2-11e7-9464-e4de00000003",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0f1e750e-e1b2-11e7-9464-e4de00000003",
"name": "not strange attribute name",
"type": "file",
"value": "filename",
"download": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/00664f3a-e3da-11e7-9464-e4de00000000",
"mediaType": "application/octet-stream"
}
}
],
"buyPrice": {
"value": 54,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "Ar23",
"weight": 200,
"volume": 300,
"isSerialTrackable": false
}
Пример запроса на создание Товара с загрузкой изображения.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/product"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "testimage",
"image": {
"filename": "birdimage.png",
"content": "iVBORw0KGgoAAAANSUhEUgAAASwAAAEsCAYAAAB5fY51AAAD7GlDQ1BpY2MAAHjajZTPbxRlGMc/u/POrAk4B1MBi8GJP4CQQrZgkAZBd7vLtlDLZtti25iY7ezb3bHT2fGd2fIjPXHRG6h/gIocPJh4MsFfES7AQQMJQUNsSEw4lPgjRBIuhtTDTHcHaMX39Mzzfp/v9/s875OBzOdV33fTFsx6oaqU8tb4xKSVuUGaZ1hDN2uqduDnyuUhgKrvuzxy7v1MCuDa9pXv//OsqcnAhtQTQLMW2LOQOga6a/sqBOMWsOdo6IeQeRboUuMTk5DJAl31KC4AXVNRPA50qdFKP2RcwLQb1Rpk5oGeqUS+nogjDwB0laQnlWNblVLeKqvmtOPKhN3HXP/PM+u2lvU2AWuDmZFDwFZIHWuogUocf2JXiyPAi5C67If5CrAZUn+0ZsZywDZIPzWtDoxF+PSrJxqjbwLrIF1zwsHROH/Cmxo+HNWmz8w0D1VizGU76J8Enof0zYYcHIr8aNRkoQj0gLap0RqI+bWDwdxIcZnnRKN/OOLR1DvVg2WgG7T3VbNyOPKsnZFuqRLxaxf9sBx70BY9d3go4hSmDIojy/mwMToQ1YrdoRqNa8XktHNgMMbP+255KPImzqpWZSzGXK2qYiniEX9Lbyzm1DfUqoVDwA7Q93MkVUXSZAqJjcd9LCqUyGPho2gyjYNLCYmHROGknmQGZxVcGYmK4w6ijsRjEYWDvQomUrgdY5pivciKXSIr9oohsU/sEX1Y4jXxutgvCiIr+sTedm05oW9R53ab511aSCwqHCF/uru1taN3Ur3t2FdO3XmguvmIZ7nsJzkBAmbayO3J/i/Nf7ehw3FdnHvr2tpL8xx+3Hz1W/qifl2/pd/QFzoI/Vd9QV/Qb5DDxaWOZBaJg4ckSDhI9nABl5AqLr/h0UzgHlCc9k53d27sK6fuyPeG7w1zsqeTzf6S/TN7Pftp9mz294emvOKUtI+0r7Tvta+1b7QfsbTz2gXtB+2i9qX2beKtVt+P9tuTS3Qr8VactcQ18+ZG8wWzYD5nvmQOdfjM9WavOWBuMQvmxva7JfWSvThM4LanurJWhBvDw+EoEkVAFReP4w/tf1wtNoleMfjQ1u4Re0XbpVE0CkYOy9hm9Bm9xkEj1/FnbDEKRp+xxSg+sHX2Kh3IBCrZ53amkATMoHCYQ+ISIEN5LATob/rHlVNvhNbObPYVK+f7rrQGPXtHj1V1XUs59UYYWEoGUs3J2g7GJyat6Bd9t0IKSK270smFb8C+v0C72slNtuCLANa/3Mlt7YanP4Zzu+2Wmov/+anUTxBM79oZfa3Ng35zaenuZsh8CPc/WFr658zS0v3PQFuA8+6/WQBxeNNNGxQAAAAGYktHRAD/AP8A/6C9p5MAAAAJcEhZcwAALiMAAC4jAXilP3YAADIqSURBVHja7d13nCVXfef9zzlVdWPnNEkjTR5JKI+EcgAkkW147F2C19jrB9Zrm/ygNU6wJjw2GJbFmGcND7vYeI2N13qwJUBaBSSRJJQT0uScU+ebquqc549T1d3Tmhn1jKZD3f69X6/WzLTu9NxbVfd7zzn1O+coa61FCCEyQM/2ExBCiKmSwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITJDAksIkRkSWEKIzJDAEkJkhgSWECIzJLCEEJkhgSWEyAwJLCFEZkhgCSEyQwJLCJEZElhCiMyQwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITJDAksIkRkSWEKIzJDAEkJkhgSWECIzJLCEEJkhgSWEyAwJLCFEZkhgCSEyQwJLCJEZElhCiMyQwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDH+2n4AQZ5pN/mMnfscCCtRJHj/5AeoEjxezR1lr7Sv/MULMLgukl7JW6qSPm+zlQslYl3Za0mvWSWCJzLIWLBYFqAkhNRhZRhuGwbph23DI/tGYgWrMaGgYbphjfwaQ9xStgaYYKHrLPme1+Cwue7TlPdpzmpwaf7QxJA0xhZIAm3HSJRSZ4lpS7vc6CY7Qwu6RiF8cbrBzsMHPDzV48mjIrtAwGFqIky/g+CljweBGdD0NPiz2Fee3+Ly6N895HT4ru/Kc1xXQFuhk4NeFl1JzP7iMpWlah9LCEpkRG4vnmlMYYOdIxFMH6ty/q8qjhxs8NhxBZEFDn6fIKwiUQuvk7pIiaY8dK/2Ota5bGVkIrWUgtowawEJPSXN1e8C1i/LcdFaRc7tztPsuuoyxoE7eFZ0Nxh7b+rRkf0xOAkvMaRYXCFq5N14ltjxxoMbdOyp8f3eNZwYjUNClFV2+wlOKCIixSZdx/OdMhZrwq1bgo9BANbbsjI1riQWKX+3LcevSIrcuK3NOi+uouOCa/bGuNHh18kQePVCjt+ixvC3AWuZ8i/BkJLDEnGWMdXfqlKIaW362t8rfvjjC3+2pQWzp8RSdvsIolyOxnXownQqVfHnKtdSMga2hC69z231+a2WJt64oc25nDnAtQT0LXcXJQbV9JOJbzw/xyR1Vtr6hj+XtQea7hxJYYs6x1rWOtFbEwCP7qvz1c8P8zz01MJZVgUZpRYSdtpA6GQ34CjxgOLLsCy1LWzw+uKbMu89vY3HRAyzGzkxra3JQ7alE/O9tFf56/QiP7avzyUta+c/X9TRFn3DeBJZN2sIZP19Nz1ibvMkVGwdD/sfzg3xuUwViy6qcBqVoWDvjIXUiHpBXMBJb9jQs67oCbruwlbeubKHkKddK1Gf+ukvLOCaOUe2tRHx/S4Wvbxzh8f6Qpb5il4aHXtfDDUtKmW9dwTwIrLQo0J3TmfvUE6cuNhZPK6rG8r/WD/O7Tw0xWo1ZkdMoDeEstKamSuOC60BoGYwtv352kT+8osN1E63FnKE6LpPe7MSOBdXmwZB7to/yN5srPHY0pMVXnJ3TvNAwvGNhjm/euoCi5/5W1jV1YLlGlWUgtNy+eZRfWVmmI6eTT/Hsn7xmkdZTaaXYMRLxF4/389UtFZb4irKnqM3hoJosUBAAG+qGs0sef3ZZO+9c24rGjbF5p3HZ2bFC/fGQioHnD9e5Z3uF/75llA3DMd2+ottXhCgCLBtrhu9c38W/XduKMaCbYCJeU9dhuaJCxSN7q7z3R0fYNxxx2xUd5CHzd0uaRTqsopTiZ/tqfOAnR3hyMGJtQVO3UM1KUiVCCyGwOq+pNAy/9pOjvHi4wcde3Ul7MPUPS2uT7rFWE6YIKQ5UYx7fX+POLaN8bV8N6oaFgXbHC3e8AmXZGFpu6clx87Ky+5tNcq03bWBZXH99MDR884VhyoHiT54fprfk8dsXtCXTOGRMazYZCzrpr//DhmHe/fMBiC1rC5pKxoJqspqFQCvW5BSfeWGYjQMhn72+m1VtwXFDa6wEw47fGfWSxwyHhqcP1Xl4d5Vv76y6Ug5gWaAICj4h9pjjFaAgNvyf57XQldeuLKRJxkGatkuYXhTf2zbKWx84zJqcJjawJbbc9bpu3nB2eWzMRMy8iYPrf/nUAB96cpBlgcbXipq1aLLTDTwZBZS0Yn0tZl2Hzzdu7OGSnjxxUrKRPkZNCrADtZjt/Q0e3lvjjp1VHhiKoGHpCxRtvkLhbj6YSf9eTsGWhuGXenP87RsW0BHopupNNGVgpf39kRjef99B/nZ3jZV5jUVRiQzkFHfc3MsVfYWm+vTJCpMEEkrx5acG+PDjg6wpahq4cR5Fc4RVygJlrdhQj1lV8vjH1/Wyrjd/zGOONgxHRyNe7A95eG+Vxw41uG8wgtBSChQLPEVOKepYjD3xJO4csDmy3PWabt6wrNx013dTBlZ6kn6+v8ZVdx9kpacISSa6KsXu0LCs7PEPr3Wfds12UueyNKxsElYfeWKA1QWPRjKdr5kVFOwIDctKHt+8oZu2vMeTB2rsGwj56ZGQO/tDqCdHwVOs9hUoV29mpnB8igo21gwfP7fMZ67rwbMW22SlPE0ZWNa6uymf+flR/uS5YVYXPGpJzYrBndg9oWVVi8c/3tLLeR056R7OgIljVl9+eoAPPzHImrwbXG/2sEpbjTkF/ZElpyGnFDvTydmeYlmg8JWbChTh5jRO9c0ZKDiUXNO3v6GP5a3Zr2o/nia40XmstL++rxpz/64qgaeIk9NukxdctXBWoHh2KOLDPz7KjtEYTyti03TZPWekA8ooxd+9OOS6gfMkrMZeP9Cw0O4pAqWILazJKdYWPVbk3ITuhrVUrT2lmjMFeBaGjeU/r+twYWVs04UVNGNgJSNYzx2o8+BwzLJAEdmJ/388tNbkNfccrPP+Bw+xfSSS0JpGabf7/t1V3vPzAZbl9LzoBh5PxPj0npqFyoSAOp2rr6RgU93wqQtaefOKsrvT2IxpRRMGlsYV1T26v0aaVJMvgvTPVQtr85rv7a/zgYeOsFNaWtMituBpxeahkNsePko3btmpeLaf2CwyydfpXmlpF7OoYH3N8K6lBd5/aQcerqq+OeOqyQLLlVYp+msx9+6r0R5oopf5O6NjoVXj/Q8eltA6w4wFT1lGYsunH+nnqaGIbl/RsM0wUWR2TByL3dgw3NAd8NlruulMSnem0riyuBsgWbvKmyuwksO/fTjiheGIdm987tWJKKCShNad+2v8zgOH2DQk3cMzJinQ/fYLQ3xrR5Vz83qsel2O7qlLw6qg4GhoWFD0+NL13Sxv9ad04yhdX4ykTlExvoJrFjRVYKWePVTncGQpqKm/KSrJmNYPDtb5tXsP8kJ/Q0LrFTLJEjEv9Df41HNDLMm5eYHi9KUtq6OhweY9vnNjN5clhagnK80xdnwFUq0VsVI8daTBwWqMOoX3yWxrqsBKT9eBgRCMm3hzKieiYmFNTvPYYMiv33+YJw7V8bRbIiQrJ3SucDc3LA1j+aunBthTNZQ8Na/HrV4pixtg39kw+HmPf31NNzcuLo7d0FCTHpuGFMmsAq0U/aHhR/uqfPCBQ3zl+UFypzMbexY1zVzCtJxhMDI8MxCCdrUsp0LhBuJX5zS/GI54472H+Pvru7hlaQlsMpU6W+d31qS1cPdtG+G/ba+yOudKGMTpUbiw2lA3XNTu8//e0M2r+wpjLau0a2eTcSlPpdN9FKOxZdNAg4f3VvnBjirfO1inL+/x8FsXZG71kuYJLFyLaqAW8+RozOLT/DRPQ2tpoKmEhlt/eJjvXNPFr6xucXdgZD2tl2WTgsWBhuGvnh92m0aobI2VzCUebsrNhlrMmxYW+MJ13ZzXERAZmwTV+EJ+6ZzEkdiyY6jBs4ca3L+7wj37G+yqxHQlfaq/ua6LFW1B5gqmmyawUpW6YVPVsEyrlx1wP550uZO6tRQ8xTJjecePj/KFkYjfu7idgobYuNvy4vjS1tUPd4xw18FGU6y+MFtyCkYiy/bQ8MG1Lfz+FZ0sLnrExuKnWwEBVWMZaRg2DzR4fF+dpw/X+d6BOgdrrrpria+4uOTxTCXmzy5u443nlJLi0uyEFTRVYLmoiSMDDYNX0KcVWBOFSf3QSt/ysScG2TkU8omruujOe7O20cBcZ3GDuoOh4W/Wj4BWL1taIo5PWcuWumVtSfOlq7t559pWFMnKq0pxpBazcSBk52DI44ca/PxgnZ+NxlCLQSnOChSrcgqjNAGWZ6ox71xa4D9e0p78A9lbxaF5AitpGu0YdR3BM3Ue4uTiWJtX/OXGUXaOxHz6mm4u6Ayw1ibztTJ21qdROpb4+L4adx4KWR0oGbs6Rclq3sRK8d7lBf7dhW0sawn4xZEGu4ZDnu8P2dwfsnU44pGRmJFKDBo6tWKZhlzRxyRzEetADsve0HJxm8+fXtVFR5DdNbKaJ7ASVXPmJ3sYoAKsLXr8y/46z9xzkL+6soM3LSu7upgMDVpON63cBIPbt4y4DZWVognn1087Yy05X2M8xXeeH+JnR0OeGY2ZOM+sqBR9vmJx0XPbnCW7CFUnHG8faBgY9hVfva6LNe3ZG7eaqHkCKzn+Qw2b/FFxposRKhZW5TWDlZg3P3CYL10S8psXtNMRqGPu1sxX6eoAG/obfHdPnSW+IpKwOmVuwoYiiiz/Y3MFLHT6iuUeeDmd7GCdTO+xUDtBxbrGvcG3hZZ/ur6LaxcVMzluNfk1NYX0FBysTF+ljxuMh1ZfscJTfOSJQT704CG2Dod4WmGNdXUv85Z77T/dVWF/zdDizc/JzWdEsnvr8oLHqqJHR6AwStHArfjQsK6xdaL5iApXDb+pbvjipa38mzUtye5R2R53bZrASk3nyUgvjBCIlGJtQfOtHVXefvdB7tpRQWuFVvOzOt6toa8YCg337q0ldXAZfmfMEZG11K09JpymcnWVFGyoxvzpha184LJOwGIzOMg+WdMEVnoS23Iz85Isrou4uqDZPhLzph8e5s8fPcqBmps87Qbk509wpS9133DIPx9ssNzXhPPo9c8lZQXrqzG/u6rExy7vJACMbY7hiqYJrDSxet2OkckWX9NL4dYz6gkUKz3FHzwzxDvuPsAj+2so5VpbZp61th4/1IDQSp3aLCkny828b0WJz17X46ZDNdFifk13Wc3keRnrIloIlbuL+NDRkKvvOcQXnxjgcC1Gj7W2ZvvITK901uZzB+sATbPrTZa4lpXhnUsL/Pn1PXQEOtN3BI+neQIrOSdLS2kLa2ZPUtpFXBlolmH52JMDvOPuA9y/q5K0ttwdnWbsJaV3tQZCw+ZkHqdpig5IdqQtq99YVuS/3tBDV675wgqaKbCSN0hrToOvZmX8SAENkkLToscP+yNuvv8wn37kKDtHQnQy6JnFhdNOJj3Uu0cifjIac5anTnniuTg96aTo9VXDe5cX+dKNPSxIpu40W1hBUwWWkws0CwqayMz8ipbpW9Qw3tpa5Sk+8fwwb/z+Qb69fpjROF04rfkG5YdHIg6MxJS905vHKU6NBgrAhprhA2tK/MUNPW7VUducYZW+5qaQnp72gselZZ8jxjLbS/00rKUBrCl4HKwafu0nR/mNuw/w0O4KMW5QvjnuJrrnv68Sg5357vh8kh5ZH7eCw8a64U8vbOXzyZiVW5K6eY9/0wRWuiBQR15zYYtHJbZzoozf4qZKtPqwtqC5/UCDm+47zO//6DDPHWmM3U3McnBp3BZVm0YiUGDO+BwDkUr3NmwYy6bQ8MV17Xz81V1jq4g0acNqTNMEVrrWtQ+s6AzcTPQ59Ekf2WRqT86VQHxx0ygX/eAAn3r4CBsHw0nBNdvP9hQpV+C4txKPTRsR06OoYFfDsMdTfPfGbj58aQc55eqs5kMpSVO+xFU9OfAUDTv3Oid16yrlV+c1Z1v45PMj3Pz9A3zusX7WD4RjdxTTFldWGl2xgYNVI4E1TTRucH1j3XBxu89jt/bytpUtKGuxtnnqrKZyHJpGslAsazsCLi1qRszcfIEWV3CqFKwpakxo+PgzQ7zpBwf4/OP9bBgMsUmLSym3y8mcb3VZCOO5/iSzSWExxrKhanjP2UW+fUsfl/cVkqLk8VVG54O5+H4+fcnukj0ln6sX5DkUmVkfeD8Zg1uOOdCKNQVNIzT8/tNDvPn7B/jjnx7h0YM1qskqEFq5Fpc5hS3MZ/S1WMtgxS0cNxefX1YpQFvFQa34r1e08/+8tpdVydLG83EByaYKLLc2FRS14sZFBcCthz3Xxbjg8rVidUEzGhr+7IURrrz7IB9+4BB37ahwqO4uUJ3cXJiLra559t6ZEXml2N4wfPLcMh+6pIOy51rcnlbz8oDPhRtpZ1ZyEi9YUGBF0WMoNBR0NraXMriuYkErVhcVkYGvb6/x9Z013tKb4+3LS1y3tMjytoAgeZ3pnUU1B3b0ycp4W5ZoAAvdBffR6/YTmIdJlWi6wFLKbc+yut3njQvzfHVbhVV5RZaGV2Lc0sxKwaq8wlq495DbVGDVs4O8bWmRW84ucdnCAt05nWT0eItLqdm5P+o33dU0+9LLNkpO7mx/KM22puoSwni3MFCKt6wojX0viyzjdxUXB5rVec1Iw/KFF0d5/f2H+bc/OMAXnxzgZwdqHB7rMqqxQVq3kebMPFetFe1FD+bgndksU2O/ylGFJmxhAcnHkOXShQVu6s7xeH9IX6AIM9TKmsji6rgixruLxsJj/Q0eONyA54d4e0+O6xcXuHZxkRUdAT1j64JZsAqT7tw4TUMfCsjN466KmBlNGVhagTGwoODx7lVlHvx5P4tRhLP9xM6Ase4i0BtoFgVueZvv7q/z3X11eHaIX+rJce2CPOsWFji/K0d7XlOaECbWMlaLrlyF7SsOMd+DRWXPLcM72wdJNK2mDCxgrLN/y7ISl744zJ5KTCkjg+9TMbHVpYEVOY0GQgN37K9zx+4a5Ie5pORx/YI8Vy7Is7IjYHVnjrZAExwzGGIxhiRpVPrLlIPHJvPXFpX0WGAlFSZCnFFNG1g6Kbhc1uLze+e38t5H+lmTV1Sb8F2U7p6Svu6VOQ8vZ4kM7BmJ+crQKF/ZMEJXyeOaNp/zugIu7Suwuj2gu+SxsORRPEF37tj5jccPM4sLzVe1BWAtnsSVmCZNG1jAWCvrLStbuGnjCI8ORCzM8FjWVBjcKhHpyy8HinY0Gksthu8dCvnegQZsGAVPcUWrzyUdPivbAha3BZzb4bOkxSfwNOVAHdOVHGexNvl+Mo0IpWjJa/B1Zidxi7mvqQMrbWUtKGg+dFEbb3/wCH6TjGVNhcWNd8XJgi9Kua6jwm2DHlvYMhTx2NEQTAV8Bb5mZU6xttVnRavPBe0BHQVNW9Gjp+TRW9B05j0C7Y6vRo3tILyoM8fFrR67R2LafDVxz08hzoimDiwA5UrDuXVZmfcur/CNrVVWFzS1efZmSreHGi80dQHW7iu6fDV2oyI0UKkZ7qs0aOyruyabAnKKs3KaRTlFT6Bp9TWdJU1bzqOvqCn7is6CR5eGjRbaZvsFN4nxRSHn2QV7As0fWLhWRslTfOjSDh482GC0bsh52SomPdPGA8wN3I8Nlms3HeQsQKPxkjdKaKHRsGytGx4z0UuHqFzVBAt9Ra8nraszIb15ATO3fd1c1/SBBe4OljGWCzpzfO6KDn7loSOs0YoaMjQ80dgmnZbkbup4awzA86ANNyY2cV3R9FebFLnKMT2T3NHM68lHe36aN7Gt3CJTvGVFC/9pbQsba4aSrN00Jce0xiyE1roW16Sv+TI2OJMsgJrf8wcnmj+Bhdt6KqcsH7u8kzcvyrO+bkhKh+b559YrYyd9iTMnStZEbinMm7fqSTXdUTjZHfV0b8DevObLN3RzVWfA9oYLrbG6SSHmiHT8NacVBb/p3qqnpemOQrJYwwkn/Wrltu5e2Rbwleu7act57KkbikpCS8wtSrnu91JfjQ26z/frs6kCy1g4XI1RimRd9OMHl6ddaF3em+dfXttDMa85GlqKSkloiTlDAVUDfTlNl3QJgaYKLIvB8ic/PsyXnuhnz2g0Ibheurywp93u0NcuKvAvr+tB5zWbGoZy0tISYrYpFP3G0pfTdOc9wMp6WLP9BM4Y67p7YcPw0UcH+eW7DvCFx/tZP9CAZJ0orVyFd7objUrKHa5dWOSum3tY1+qxoWZome9XhZhTWvx0JyW5LpsnsNIXpICC5kjFcNvTQ9z6/QN8+IFDfG/bKHsr0TG70aTV3lFsWNdX4Nu39HJTb4711Zh8Mx4ckSlpPPW2+FLWkGiqwlENFAs+mAb5nGZNwWMkMvzl1gp/uaXCFZ0Bb1yQ4/wFBS7vy9NT8mgNNH6ytc6ajhz//IYF/MVj/XxuwwiLfEVOK+kiihnnqtzdAMZZLR6+LIABNFFgpbVUQbI7g7FQs5acVqzOu+9tH474VH8IGyucl1es7gx4dXfAue05Oso+vWXNkhafj1/dxfk9AX/05BAmMmgloSVmQRJQK1t9PNx8wvm+VHLTBFaqs6iP+SRKV+gE3ATdQGEN9Mdwx4EGd+ytu8cHirNzmmWBYnGg6GsL6AkU+0PIz+9rRMyyhaUsbFY3M5omsJIlmTi7NUi/85LHxNbt/6eAgoIVgUIHbq0oY6EaWh5uGEIDHA5ZHEiXUMwOraAWW3qKHuV8Gljyydk0gZVa1epeUlpPdbxuv2Viy2t8gm+gYalSyWC7pmGtDBuIWaGBfgOXlz3aC1I0mmqewEpKEXpKHhQ0kUmq3qf4148NsfQ7QswOD8VoZLi4zWdJycNa6/bcnOea5s59eipbix43tvoMxha5EyyyKr10+0oe3tj9QtE0geX6f5a+gsc17T4DsSV4xT9UiJnnNgO24CmWtMtVPFHTBJZbPsa9oJU9ubGPKGlkiSyKLODBBV1pYMmVDE0UWBOtW1jgrLymYuQ0i+xRChrGsizvjZU0yHXsNFVgqWSL+mVtARd2BByRcSyRQT6KvbHlup6A1mTSsySW01yBhavH6shp3ri4QDW2k3Y4FmLu8wFiy5VdOdoDjZG8GtNUgQXjxQjXnFWEvKYem+Z7kaJpjQ24B5rF7f6E7wpowsBSyZKj5/Xk+I0FOXaE0soS2aGBodjyqpLmvO4cIHE1UfMFFm7ic0kr3rKi7NbJmu0nJcQUaQUHDKxt9TmnxUcW7TtWU76X04rga5cUuabT52Bo3PIcQsxxGsBa1vXlyftaFu2bpEkDyy2LvKjo8eurW6SIVGSCAlQyCHt1Xx53f1Bq3CdqysBy3CfTm1aWuaYz4EhkpZUl5jStYDi2rGn1WdwuBaPH07SBpZS723J22ec/vqqVI9LKEnNcgGJ/ZLmpM2BZm4+1Ukc4WdMGFpCszmh5y4oyb1uUZ2PDyGJ8Yk5yl6UruLpsYZ68kgnPx9PcgaXAGOjMaT5wUTto5Rb6m+0nJsRxRAbwFNcuKiTfkSt1sqYOLACV7Kh601lFPnFumS3JLs8gl4OYO3yl2BUZ3tqbY0mbG7yQcoaXav7AAgxuFdH3XdTBzb05NjQMuVNY3E+I6ZbDEkWW1y7M05nTbsG+2X5Sc1DTBxa4uy/GWs4qefzplZ3ga8LYIkv7i7lAAzUDFDSXLHTdQYmr45sXgQVuV2hjLNcsLPDfL+9gZ2jJId1CMfu0gn2x5eb2gMv68mPfEy81bwILxucZvuf8Vj55YSsbazEluTDELPNR1CPLL59doC3QWBmrOKF5FlhuVVIfy8cu7+T9a8qsr8SUJbTELNFAbCzkFdcuKQIytnoy8yqwIOkaWmjxFJ+8qovfWFFkfTWmRUJLzIJAKbZGhn/Xm2dNdw6sTHY+mXkXWOBCKzaWnrzH56/r4V1nF3lx1LW05FoRM0lhwcBNS4uUPY2Z95vRn9y8DCwAT7vQ6it4fPnGHt6/tsz6akxhwkGRC0dMJw3UY0t3SfOapYVX/PPmg3kbWDAeWr0Fj8/f0MMnL2pjY93gWSt1WmLa5ZViZ2h579Ii57RLd3Aq5nVgwXhoFbXi96/o5Cuv7mCrhV0NVxEv14+YDgqIrQUPbjmnhAfSHZyCeR9Y4ELLWCgo+L2L2vnxrX1c3hmwsWrIAYFcReIM8xRsiSy/3JvjqsWuOyitq5cngZVIC/WstVy3qMA/3NrHH76qhc2RZW/DUFLIelrijMkBxJZ3rWqh7MvOOFOlrJUytYksYIx1XUXg3p0Vvvj0IPcdaNDjKzoDRYhbN14OnDgdgYIjkWVlyeOONy9gSdnHWKlunwppYU2iSLuIFm0tbzi7xN+/fgFfu7qTpS0em2qGkciSV66GRq4xcap8YDC0vGt5yYWVkYX6pkpaWCdhrVtTWyeDCztGI+7cPMrfbhrh8cEItGKFr/AUxEDsSmqEOCG3yQTsULDhLQtY05mT1tUpkMCaAmMBa9F6PLge3Fnl9i2j3HmkAQ0Dvma5p/C1IsLdAZIDKyYrKsXGeswfrC3zmet60NZipaU+ZRJYE9hkXErh/qOO9/8nBNfR0PD8oTo/3Vvjf++s8tBQBKEbPV0cKDz52BQTKMADthl45PW9XLmw4IYe5PbglElgnYSxY/F1jPSQeYqxe9GDoWFjf8imo3UeO9Tg/v11jlZiPC1rcwsnr2Bz3fDhlWU+f2O32xRFwuqU+LP9BOaCNJbWH20wGln6Wjy68h5l7wQX04SLLLSWgYZluGEoKFhY9mEgohrLQKoYp4HIAr7iHee2EKjkxs5sP7GMkcDCdfWUgp/sr/G+Rwd4TafPWQWP3pwm7ynaSh5+soFF2lUcqcXUQ8NwZNlRNTxbidk5Ermr0lMs8RVadj4RiZyCTTXDB1eWWLewkEzDkU+0UyWBxXin743nlFjxzBA/PRzSIEqKrU5wC2dswEuBp1ioYWWg0Tk3jGWQOi3hKJIbN77inee1EuCuD2ldnToJLMa3tl9Q8njXsiKf/cUIF5Q0jSRxjjfM54avFAZ3McZYQstYSklYiVRewaa64UMrS6xbIK2rV0JCPmFR+Epx6zklCBSjkaVmLFVjqVle8lW1UDHuMQ1riZMG14TMEgKNq3rpyGvec0EbuWTVW4mr0yOBlXC9PsurFxb4tYV5toUGXz4FxSuUU7AjNHxoVZmLe/Kunk+uq9MmgTWBsYqCVrxrTQso8GRvOPEKeMBQZFlR8njXea1jS8iI0yeBNUH6wXfD0hK/sijPpoYhJ5+G4jTlFByILB97VQtr2wOZM3gGSGBNoABjoNVXfPDCNlfCIHW14jQEwO7Q8treHP/Hmlb3Tfnwe8UksCZRGrCWq5YU+Z3lJTbVDUW50MQpULg3VsVa3n9BKwsKXjIFZ7afWfZJYE2S1szklOK3L2qjXPSoxUYOlJiyvILNDcP7l5d40/KyK2OQsaszQt6Hx6G129b+4u48X7usjZ2hm3YDcjtanJwHjMaWc4oe77u4nbxWbq12uXDOCAmsE0gL+962ppV3n11kQ81Q0krWuxInlVOwt2G57YJWLurKyUD7GSaBdQJKudUayp7iU1d2sbrF41BoyMnFJ04gp2Bjw/DmRXneeW4rIAu1n2kSWCeR7hC9sj3gr6/t4mgywCUHTUymwW0XF2j+8PIOunM6WUlUEutMkvfey9DJKg2vXVri6+s62NqwFJAPTuGk10Fewfa65dOvauHqhQWszBecFhJYLyNdfRQL77ugjc9c1MqGakxZrkWBmzeaV7Cxbvg3S/P85gXt6eUiH2rTQAJrChTp5hKWj13RyR9d0MqLSWjJRTm/eQrqsaVc0Ny2rtN1BY3MF5wuElhTpJWrz8or+OOru/ijV7WyvhJTVHIQ57OchV2h5cuXtnNFbx5jpCs4neS9dgq0Gt/S/k+u7uKTF7WxoWYIsGO7Qsul2vzSc1xMuoIfWVvm3ee2JutcyQyc6SSbUJyGdJpFjOJrzwzye08NskRByVPU5GjOC3kFuxqGyzsCvv36Ps4u+7IDzgyQFtZpcC0thYfldy9u57s3dFPzFZvqhpKMazU9DwhjS91T/PnVXZxd9oll3GpGSGCdJjempbDW8rYVZe59fR9vXpBnQ83gJ2Ndovko3EoMO2LLN6/o4LpFBRlkn0HSJXyFJm6ueqRh+Mazg3z8F8MQW9bkNBFuUwqRbWmpQknBhprhExe08sdXdREkO3zLQPvMkMA6Q2Jj8bRbG/4n+2p88akB/nVfnaJWLA0UoYUYWe89i9KylnISVm9fkufrr+ujJy1hkMmCM0YC6wwyFhTutnZ/aPj+llG+8eIwDx0J6fAVvb6bPB1aCa6sSFtW6ZIxl7UH/NMtvaxsC5IPKQmrmSSBdYZZki5i0kXYV425e+sof7dxlAeONkAl+xcmu6dIeM19ATBqLF6gufPmXi7ry0tYzRIJrGliXHKNdRf2VmMe2lnh9s2j3H6oMbZD9Epf4WlFZK3btxXZKmwu8YHIWHZZuPs1Pbz+nBJx8oEkcTXzJLCm2eTgGgwN6480uH9nhQf31Lh3OIa6AU/R6SnatOt+aMAoRWzBJPEVS2tsRimggFsy5lvXdPLr57W5SnYtYTVbJLBmiLEA6WJu7nI/VDdsPtpg/aE69+yvs3Ug5OmaoREZN0IP4Ck6tNu8tV1DXisJrRmggBKwvm74L+va+cilHWAtVlpWs0oCa4alwZVudZ+qxJaResymoYhtAw2GR2L2jEZsrhl2VGPKWtFfNxyoxnhKQms6Kdy0mw01w59d3MZtV3S6PQUtsnroLJPAmkXWgh0LL5hcI2+A4dDiKcvuSsynf97Pt/fUWOErqe2aRq1a8UIl4g/ObeH/vr4HkLCaKySw5oik4YVN2k7GWHztZtJuGQz59MNH+Pt9DZb6imi2n2wTa1GKF2sxH11d4rPX9VDwlITVHCKBNcdYwCbFiCFw+4Zh/q8nBtlbiVme1xJW06isFOtrMR9ZXeLT1/ZQ9iWs5hoJrDlk4mz/nSMRX35igP+yeZQlvpKVIKZZWcH6quGja0p85rpuip6WsJqDJLDmgIkV8hVj+f7mUT7z9CDPDkWszmtC5UoaxJmngSKwvmH46Koyn762i5KvZamYOUoCaxZNnDgN8NyRBl99ZpCvbavQ6ys6fUXNSO3VdPEA31o21w2fvaSdj6zroKilGziXSWDNgsnFpLtGI/7X+hH+8MVh6g3DmpwmtMh41TRI5wb6yZZt20LLFy5t50OXtePjlgySsJq7JLBmkLUWaxkLqqOh4Z5to3zh2SGe6I9YmtfkNdTljEyLdNWFgoJabNlt4ZtXdvCb57UBVvYRzAAJrBlgXMEVWgMoBkLDgzur/M36Yf51f50uT9HjK+o23Z1HTJeigm0NQ+gr/vX6bn5peRmsxSBhlQUSWNMotqCsHQuqIw3DAzsr/P2GEf5lv1u5YXVOEUn3b0aUFGyoGy5u9/lv13W7DU/dHQ9ZgC8jJLDOMGvt2KBt+ibYU4l4aHeNf9w4wp0H6qBgVaAxyi3aICdgeqTjVR6Qx4XVry7J8+fXdrOyLRjbkkuyKjsksM4Aa123TzE+PtUAtgyE3LdjlNu3VnjoaAhasTqQRfxmUk5BFFt2hJaPntvCH1zRSU9ej20aIWGVLRJYp8kmy74oGFuBwQCH6zGP7atx364qd+yusXU0psNT9AaKGFnffSYVFextGEZ8zTfWtfPu89ooamTxvQyTwJqipBJhbLJyOkBrgKHQ8MyhOg/vrXHX7io/OhpCDItzirLn5v7JWlYzx8OtKbahZrimK+DzV3dy7aKiDK43AQmsEzBjR+WlFc8hsK8Ss2co5P6dVR47VOeOIyHUDe2+u+OnNYQTlrUSMyOfliyElt9ZVeK2yztZ3uIn41UyuJ51mQssaxlbheV0L70JWZT83h7z8yYv9VIzlsGGYe9IxNMHG/ziSJ2fHWrw8FA0NmdmeaAJtAszaU3NnHRgXePqqzY0DF15zRcva+ed57ZSUErGq5pIZgLLWl56wSV35KZ0JVp3+9pVGBz/8RFu/W5jYcdIxPaBkIOjEc8ebfCzgw0eGU2WMzaWjkDT5bmWlIFkKWMxGwoKGgZ2NAy/elaeT7y6iwu7ckgxaPPJRGCljaqBhmHbUEhvyaM971H0FP4p/qwIqEaWodBQCQ0jDUMUWfZXI57vj9g1FLJvJGZLNea50diNkmvo0opWrch54z9HWlKzywMCBZtqBvKaL1/UyrvOa6M32S8QJWHVbE71/T6L3NJ2d+2u8U/bK6zMKc4qebT4Cj/ZrKGc07QWPFdZjrtYa6FhsBajFYSxZTA0DEWW/XXLgbrhuVrSappkgadY6Sl8XxMDcfJpXZeQmnUK16oajC3bI8u/P6fI71zSzhW9eQDpAjaxTLSwYLxLGGN5ZG+Nzz0+wJ27auApN5PV4K5kzXiipAMcsT12gEqBpxVdGkpKESj3WJuMXVlcyUI68J6JAzQPKFxdlbWwpW64uM3nP13cxttWt1DSKmlVyeTlZpaZwIJj19Ueiix3bh7hq78Y5uHBiFWBougpaualL8flkPuLybQ+TNJiM5NaTJk5GPNMoFwXcFOyJdptq0r89kXtrGwLxsYyZfut5pepwIIkbCYU/u2txHz7hSE+t36EwzXDirzGU9J1axa+cjsv7wotVQvvWZLnfRe2cfXiYrKTjRvhlFbV/JC5wEqlRZzpoOrzRxp8Z8Mwn9lcgYZhVV6jFDTk7l0mBUlQHYws/bHl9b05fvv8Vl6/okxJu36hRcap5pvMBlZq4vLCFnhkX5VvvTDCX++qQmRZkdOuiFOCa85TuCHJHLAnsoyElks6fD58fitvXd1CV84NULqhKun+zUeZD6yUsXasxiq0licP1PmfLw7zVztdcJ0daIrJDsoSXHNPoBQ+loORZSCyXNXh8x/ObeENK1pYVHK1JLK6gmiawEq5zQMA3GTjx/ZX+aeNo3xjR5XhmmFpzg3Ox7hga6oXnzEad9cPYFPDLV5/XUfAv19T5s2rWlhQTILKWpR0/wRNGFiQTlS2aFwJgwWeO1znnzeM8LUdVQ6OxuAr1viKSEmV+kxKV7cIcLMKtjVcycmtvTl+a02ZW5aX6cqPt6ikTEFM1JSBlUpXWJh4wW8bCvnB1lH+v20Vfng0BBjrLjaQ6vXp4mqoFNpaDsau20dO8R+WFHjbijJXLSnSmdPA+MRzCSoxWVMH1kTGpvMI3Z+P1GMe3VvjO5tHuX1/nZFaTKev6fIVnoIIRSRdxlfEdflc9W7DwI7QtWOv7Ah4x/Iir1la4lW9eYLk8cZaGUwXJzVvAis1viGEe1vUYssLRxv8ZFeVf9xe4eGBCIyl5CnO8hWxGp/cPK8O1GlIu3saV+QZGsv2RnLgipr3Lc5z81lFblxaGhufcmtUuZCSMSrxcuZdYKXGNjGd8E45Uot59lCD+3ZV+PGBOj8+GoKFFk+xIJmz2Ehuq1skwGA8pHwUHpbh2LI3ti7hix6/1Zfj8oUFXre0yNL2gKJOZxy41qu0qMSpmLeBNdHkjU0BdlciNh1pcO/uKj/aV+enQxE0DOVA0+O5+YdaHbtqQ7MfyPTouEFzhcISGqgay/4oWRes7LGuI+Ct5xS5pC/Pmq4chQnHVSYmi1dCAmuCtHoexpcliYHDtZgnD9TYcLjBXfvq3NPfcJWokaXoaxb57k6WVcdOnM76gZ3YxVOASl7QSDweUPiKNSWPNy7Mc3lvjgv7CqzpCCh6aSKlk8hVOu9ciNMmgXUC4+u3H9saOFI37BuNeOpQnV8cbPDo0QYPDEQQjRdG9HmKVk8li0i4ejCDHZt4DXMnzNSEX5UCjUrGoFzQVIxlz8QBPAVrWnxu6g5Y3Rlw1aICK9sDOgreWHfPHb/xqTMSUuJMkcCagrQ84njru++qxBwejdg6GPKz/TV2DEVsGo15djR2y2AmTZRepShoV9Ht6fG1xY0dXzli/N85fqCd7ESpl/m+Cw6FTkI4zRZjLcZAaC0NC4PW3YjAWPAV55Q8zi96nNPuc3lfnvM7A7pKPue0+RQmHYvYHvuzhTjTJLBOUZJbY2vBTwywhnV3xnaNRGwdCDlaidg0FPJcf8TW4YgtdcNIlAxIx8k6qhrQih4NReVKKtLe1Eve9y8XBPalvzW47GkYS81Cf7qmTlrslPyDHYFmsa84u+xxYWfA2naf3rLP4taAlW0+JV+Rn5hEyQ40yB0+MYMksF4hOyG8XPdxwi4ZuEH5oYahEVuO1mK2DUfsH4k4UokZrBv21WL2VWP21Qy7a4YjE8vuJ+64MZXTNDE1junrwYq8pien6StoFhY0iwoebTlNV9lnYdljVZtPW87D8xRtOUV+UgLZY2rSpKsnZocE1jQwE5phemK16nGMxJbh0DAaWqqhwRhLJbJExrK/EjMcGgKtGG4YDlWNG9xnfDFVlfx75UDRW/LGll1ZXPIoBYq8p8h5mrynyPuKUqBoDbRbouVEkm6qI108MXdIYM2AY7uR4384lX3yLCff41DhijWnytgJo+gTfyctJzGHSWDNMjvpN/bY75K2pdTY70/2s050KicUZ0ogiQyTwBJCZIae7ScghBBTJYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITJDAksIkRkSWEKIzJDAEkJkhgSWECIzJLCEEJkhgSWEyAwJLCFEZkhgCSEyQwJLCJEZElhCiMyQwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITJDAksIkRkSWEKIzJDAEkJkhgSWECIzJLCEEJkhgSWEyAwJLCFEZkhgCSEyQwJLCJEZElhCiMyQwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITLj/wcpq/v2GehmhAAAACV0RVh0ZGF0ZTpjcmVhdGUAMjAxMy0wNC0yOVQwMzoyNTozOSswMDowMLu2PQ8AAAAldEVYdGRhdGU6bW9kaWZ5ADIwMTMtMDQtMjlUMDM6MjU6MzkrMDA6MDDK64WzAAAAAElFTkSuQmCC"
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Товара с изображением.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/bd1c0a3e-95ee-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "bd1c0a3e-95ee-11e6-8a84-bae500000004",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 14:25:28",
"name": "testimage",
"code": "00006",
"externalCode": "0bmPIvHxgEDlNIZrZ6GLt2",
"archived": false,
"pathName": "",
"image": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/bd159783-95ee-11e6-8a84-bae500000001",
"mediaType": "application/octet-stream"
},
"updated": "2017-01-11 14:54:10",
"title": "birdimage.png",
"filename": "birdimage.png",
"size": 14052,
"miniature": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/bd159783-95ee-11e6-8a84-bae500000001?miniature=true",
"mediaType": "image/png"
},
"tiny": {
"href": "https://online.moysklad.ru/app/download/bd14f0b6-95ee-11e6-8a84-bae500000000.png",
"mediaType": "image/png"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 0,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"buyPrice": {
"value": 0
},
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean13": "2000000000107"
}
],
"variantsCount": 0,
"isSerialTrackable": false
}
Массовое создание и обновление товаров
Массовое создание и обновление товаров. В теле запроса нужно передать массив, содержащий JSON представления товаров, которые вы хотите создать или обновить. Обновляемые товары должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких товаров
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/product
"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "Мандарины"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/26b36824-2c83-11e6-8a84-bae50000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"name": "Брюква",
"description": "Брюква, Брюссель"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных товаров.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/04996e84-29a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "04996e84-29a1-11e6-8a84-bae500000002",
"accountId": "2aa3f5df-296b-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"salePrices": [
{
"value": 346347237000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"updated": "2016-06-03 18:37:02",
"name": "Мандарины",
"code": "00003",
"externalCode": "Cf0ehavIglre6sMX-J2rR2",
"archived": false,
"pathName": "",
"weight": 0,
"volume": 0,
"isSerialTrackable": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/26b36824-2c83-11e6-8a84-bae50000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "26b36824-2c83-11e6-8a84-bae50000001b",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:00:37",
"name": "Брюква",
"description": "Брюква, Брюссель",
"code": "pumpkin1",
"externalCode": "456pumpkin",
"archived": false,
"pathName": "",
"vat": 3,
"effectiveVat": 3,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 3753,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 3653,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313f1eb-2c7f-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "string",
"value": "Колхоз \"Иваново\""
}
],
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/0238a888-c602-4e78-a199-d8f49c4d6c18",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"buyPrice": {
"value": 54,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "Ar23",
"weight": 100,
"volume": 400,
"packs": [
{
"id": "354ba98c-2cb9-11e6-8a84-bae5000000e3",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/2d1fdd55-d935-4d55-80d4-f6904b62ff46",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 40
},
{
"id": "354ba98c-2cb9-11e6-8a84-bae5000004e3",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/0dd4fe8b-e59e-486e-bde5-b52fe0e25415",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 101
}
],
"barcodes": [
{
"code128": "code128barcode"
}
],
"alcoholic": {
"excise": true,
"type": 3100,
"strength": 0.6,
"volume": 1.5
},
"isSerialTrackable": false
}
]
Удалить Товар
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Товара. |
Запрос на удаление Товара с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/product/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Товара.
Метаданные Товаров
Метаданные Товаров
Запрос на получение метаданных Товаров. Результат - объект JSON, включающий в себя:
| meta | Метаданные |
| attributes | коллекция всех существующих доп. полей Товаров в формате Метаданных |
| createShared | создавать новые комплекты с меткой "Общий" |
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Товаров
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/product/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Товаров.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "string",
"required": false
}
],
"createShared": true
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | 7944ef04-f831-11e5-7a69-971500188b19 (required, string) - id Доп. поля |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/3cd83619-5585-11e6-8a84-bae500000069",
"type": "attributemetadata",
"mediaType": "application/json"
},
"customEntityMeta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/a27aa372-5311-11e6-8a84-bae500000001",
"type": "customentitymetadata",
"mediaType": "application/json"
},
"id": "3cd83619-5585-11e6-8a84-bae500000069",
"name": "Связанная сущность",
"type": "customentity",
"required": false
}
Товар
Товар, обращение к которому происходит по значению его id.
Получить Товар
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Товара. |
Запрос на получение Товара с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/product/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Товара.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/d950551c-2c7f-11e6-8a84-bae50000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "d950551c-2c7f-11e6-8a84-bae50000000b",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 10:45:16",
"name": "Бананы",
"description": "Бананы, Африка",
"code": "one1",
"externalCode": "456",
"archived": false,
"pathName": "",
"vat": 18,
"effectiveVat": 18,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 532000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 346347237000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313d1e7-2c7f-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": false
}
],
"buyPrice": {
"value": 23553000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "Ar23",
"weight": 200,
"volume": 300,
"packs": [
{
"id": "c6bdee6f-2c83-11e6-8a84-bae5000000a4",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6b91d63-2c83-11e6-8a84-bae5000000a1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 35
},
{
"id": "c6bdf693-2c83-11e6-8a84-bae5000000a5",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 2000
}
],
"variantsCount": 0,
"isSerialTrackable": true,
"things": [
"F564X056",
"F564X057"
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
]
}
Изменить Товар
Запрос на обновление существующего Товара. Типы цен в ценах продаж и дополнительные поля обновляются как элементы вложенных коллекций: + Если в текущем объекте у какого-то из доп. полей / типов цен нет значения, а в переданной коллекции оно есть - значение записывается в доп. поле / тип цены. + Если же у данного атрибута значение уже присутствует - оно перезаписывается на переданное. + Если у данного атрибута в составе объекта значение присутствует, однако оно отсутствует в передаваемой в теле запроса коллекции (не передаётся совсем), то значение атрибута объекта не изменяется.
Для обновленя полей алкогольной продукции в теле запроса на обновление товара должен присутствовать объект alcoholic, с вложенными в него полями, отражающими свойства алкогольной продукции: + excise - Содержит акцизную марку + type - Код вида продукции + strength - Крепость + volume - Объём тары Если в запросе на обновление товара, являющегося алкогольной продукцией, передать пустой объект alcoholic, с данного объекта снимется отметка "Алкогольная продукция". Для того чтобы сделать товар, не являющийся алкогольной продукцией алкогольным, нужно в теле запроса передать объект alcoholic, у которого хотя бы одно из свойств будет иметь значение.
При обновлении Товара с указанным массивом штрихкодов для каждого штрихкода требуется указать к какому типу относится штрихкод. Например, чтобы создать штрихкод с типом Code 128, в массив штрихкодов должен быть добавлен JSON-объект с полем code128 со значением штрихкода.
При включенном в основном интерфейсе серийном учёте товаров, в запросе на обновление нельзя передать значение true полю weighed, иначе возникнет ошибка, т.к. невозможен серийный учёт весовых товаров.
Пример запроса на обновление Товара
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/product/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Тыква",
"code": "pumpkin1",
"externalCode": "456pumpkin",
"description": "Тыква, Германия",
"vat": 3,
"effectiveVat": 3,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313f1eb-2c7f-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 54,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 3753,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 3653,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/0238a888-c602-4e78-a199-d8f49c4d6c18",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"article": "Ar23",
"weight": 100,
"volume": 400,
"packs": [
{
"id": "354ba98c-2cb9-11e6-8a84-bae5000000e3",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/2d1fdd55-d935-4d55-80d4-f6904b62ff46",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 40
},
{
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/0dd4fe8b-e59e-486e-bde5-b52fe0e25415",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 101
}
],
"alcoholic": {
"excise": true,
"type": 3100,
"strength": 0.6,
"volume": 1.5
},
"barcodes": [
{
"code128": "code128barcode"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Товара.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/26b36824-2c83-11e6-8a84-bae50000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "26b36824-2c83-11e6-8a84-bae50000001b",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:00:37",
"name": "Тыква",
"description": "Тыква, Германия",
"code": "pumpkin1",
"externalCode": "456pumpkin",
"archived": false,
"pathName": "",
"vat": 3,
"effectiveVat": 3,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 3753,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 3653,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313f1eb-2c7f-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "string",
"value": "Колхоз \"Иваново\""
}
],
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/0238a888-c602-4e78-a199-d8f49c4d6c18",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"buyPrice": {
"value": 54,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "Ar23",
"weight": 100,
"volume": 400,
"packs": [
{
"id": "354ba98c-2cb9-11e6-8a84-bae5000000e3",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/2d1fdd55-d935-4d55-80d4-f6904b62ff46",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 40
},
{
"id": "354ba98c-2cb9-11e6-8a84-bae5000004e3",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/0dd4fe8b-e59e-486e-bde5-b52fe0e25415",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 101
}
],
"barcodes": [
{
"code128": "code128barcode"
}
],
"alcoholic": {
"excise": true,
"type": 3100,
"strength": 0.6,
"volume": 1.5
},
"isSerialTrackable": false
}
Пример запроса на изменение Товара с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/product/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Тыква",
"code": "pumpkin1",
"externalCode": "456pumpkin",
"description": "Тыква, Германия",
"vat": 3,
"effectiveVat": 3,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313f1eb-2c7f-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 54,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 3753,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 3653,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"article": "Ar23",
"weight": 100,
"volume": 400,
"attributes": [
{
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"value": false
},
{
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"value": "Колхоз \"Иваново\" "
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Товара.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/26b36824-2c83-11e6-8a84-bae50000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"id": "26b36824-2c83-11e6-8a84-bae50000001b",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 10:52:58",
"name": "Тыква",
"description": "Тыква, Германия",
"code": "pumpkin1",
"externalCode": "456pumpkin",
"archived": false,
"pathName": "",
"vat": 3,
"effectiveVat": 3,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 3753,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 3653,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"supplier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6313f1eb-2c7f-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "string",
"value": "Колхоз \"Иваново\""
}
],
"buyPrice": {
"value": 54,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"article": "Ar23",
"weight": 100,
"volume": 400,
"isSerialTrackable": false
}
Услуга
Средствами JSON API можно создавать и обновлять сведения об Услугах, запрашивать списки Услуг и сведения по отдельным Услугам. Кодом сущности для Услуги в составе JSON API является ключевое слово service. Услуга - специальная разновидность товара, без закупочной цены и упаковок. Больше о Товарах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки в разделе Товары и склад.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке.
Поиск среди объектов услуг на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию Услуги name + по коду Услуги code
Услуги
Атрибуты сущности
- meta - Метаданные объекта
- id - ID Услуги в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - name - Наименование Услуги
Необходимое - description - Описание Услуги
- code - Код Услуги
- externalCode - Внешний код Услуги
- archived - Отметка о том, добавлен ли Услуга в архив
- pathName - Наименование группы, в которую входит Услуга
Только для чтения - vat - НДС %
- effectiveVat - Реальный НДС %
Только для чтения - productFolder - Ссылка на группу Услуги
- uom - Единицы измерения
- minPrice - Минимальная цена
- salePrices - Цены продажи
- barcodes - Массив штрихкодов услуги
- attributes - Дополнительные поля Услуги в формате Метаданных
- buyPrice - Закупочная цена
Атрибут pathName сам по себе является атрибутом только для чтения, однако его можно изменить с помощью обновления атрибута productFolder.
Атрибуты вложенных сущностей
Метаданные Услуг
Метаданные Услуг содержат информацию о дополнительных полях.
Посмотреть все созданные в основном интерфейсе доп. поля Услуг, а также все типы цен можно с помощью запроса на получение метаданных Услуг. Ответ - объект, со следующей структурой: + meta - Метаданные + attributes - коллекция всех существующих доп. полей Услуг в формате Метаданных
Структуры объектов отдельных коллекций:
Штрих коды:
При создании штрихкода требуется описать объект с полем, являющимся форматом представления штрихкода в нижнем регистре, со строковым значением самого штрихкода. Наименование полей отдельного объекта, представляющего штрихкод:
- ean13 - штрихкод в формате EAN13, если требуется создать штрихкод в формате EAN13
- ean8 - штрихкод в формате EAN8, если требуется создать штрихкод в формате EAN8
- code128 - штрихкод в формате Code128, если требуется создать штрихкод в формате Code128
О работе с доп. полями Услуг можно прочитать здесь
Цены продажи
- value - Значение цены
- currency - Ссылка на валюту в формате Метаданных
- priceType - Тип цены
Закупочная цена
- value - Значение цены
- currency - Ссылка на валюту в формате Метаданных
Минимальная цена
- value - Значение цены
- currency - Ссылка на валюту в формате Метаданных
Группа Услуги
- meta - Метаданные, содержащие ссылку на группу Услуги. Описание сущности Группа вы можете посмотреть здесь. Обновление этого атрибута также обновит атрибут pathName.
Особенности фильтрации поля archived
Если одновременно осуществляется фильтрация по полям id и archived, то фильтрация по полю archived не учитывается.
Получить список Услуг
Запрос на получение всех Услуг для данной учётной записи. Результат: Объект JSON, включающий в себя поля: | | | |---|---| |meta |Метаданные о выдаче | |context |Метаданные о сотруднике, выполнившем запрос | |rows |Массив JSON объектов, представляющих собой Услуги |
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить список услуг
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/service"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Услуг.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/63e4fa87-2c87-11e6-8a84-bae500000030",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "63e4fa87-2c87-11e6-8a84-bae500000030",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:11:08",
"name": "Облицовка",
"description": "Облицовка доставляемого товара",
"code": "additionalprot",
"externalCode": "addProt",
"archived": false,
"pathName": "",
"vat": 6,
"effectiveVat": 6,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 1052,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 1020,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "counterparty",
"value": "ООО Компания"
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/f6ecdc65-2c86-11e6-8a84-bae500000027",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "f6ecdc65-2c86-11e6-8a84-bae500000027",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:08:06",
"name": "Доставка",
"description": "Доставка выбранного товара",
"code": "delivery",
"externalCode": "delCode",
"archived": false,
"pathName": "",
"vat": 10,
"effectiveVat": 10,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 10532,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
]
}
]
}
Создать Услугу
Создать новую Услугу.
Описание
Услуга создаётся на основе переданного объекта JSON,
который содержит представление новой Услуги.
Результат - JSON представление созданной Услуги. Для создания новой Услуги,
необходимо и достаточно указать в переданном объекте не пустое поле name
При создании Услуги с указанным массивом штрихкодов для каждого штрихкода требуется указать к какому типу относится штрихкод. Например, чтобы создать штрихкод с типом Code 128, в массив штрихкодов должен быть добавлен JSON-объект с полем code128 со значением штрихкода.
Пример наиболее полного по количеству полей запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/service"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Доставка",
"code": "delivery",
"externalCode": "delCode",
"description": "Доставка выбранного товара",
"vat": 10,
"effectiveVat": 10,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 10532,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"buyPrice": {
"value": 1047,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Услуги.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/f6ecdc65-2c86-11e6-8a84-bae500000027",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "f6ecdc65-2c86-11e6-8a84-bae500000027",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:08:06",
"name": "Доставка",
"description": "Доставка выбранного товара",
"code": "delivery",
"externalCode": "delCode",
"archived": false,
"pathName": "",
"vat": 10,
"effectiveVat": 10,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 10532,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"buyPrice": {
"value": 1047,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
]
}
Пример запроса на создание Услуги с единственным необходимым полем.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/service"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Услуга, у которой мы придумали только имя"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Услуги.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/cce4dae4-2c87-11e6-8a84-bae500000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "cce4dae4-2c87-11e6-8a84-bae500000037",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"salePrices": [
{
"value": 346347237000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"updated": "2016-06-07 11:14:05",
"name": "Услуга, у которой мы придумали только имя",
"code": "pumpkin2",
"externalCode": "5fZe-Qyji8mSwoHYs7kSA2",
"archived": false,
"pathName": ""
}
Пример запроса на создание Услуги с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/service"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Облицовка",
"code": "additionalprot",
"externalCode": "addProt",
"description": "Облицовка доставляемого товара",
"vat": 6,
"effectiveVat": 5,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 1052,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 1020,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
],
"attributes": [
{
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"value": true
},
{
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"value": "ООО Компания"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Услуги.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/63e4fa87-2c87-11e6-8a84-bae500000030",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "63e4fa87-2c87-11e6-8a84-bae500000030",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:11:08",
"name": "Облицовка",
"description": "Облицовка доставляемого товара",
"code": "additionalprot",
"externalCode": "addProt",
"archived": false,
"pathName": "",
"vat": 6,
"effectiveVat": 6,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 1052,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 1020,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "counterparty",
"value": "ООО Компания"
}
]
}
Массовое создание и обновление Услуг
Массовое создание и обновление Услуг. В теле запроса нужно передать массив, содержащий JSON представления Услуг, которые вы хотите создать или обновить. Обновляемые Услуги должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Услуг
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/service"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "Услуга, у которой мы придумали только имя"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/f6ecdc65-2c86-11e6-8a84-bae500000027",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"name": "Доставка товара",
"description": "Доставка на дом выбранного товара",
"externalCode": "deliveryCode",
"vat": 11,
"effectiveVat": 11,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 7000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
]
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Услуг.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/cce4dae4-2c87-11e6-8a84-bae500000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "cce4dae4-2c87-11e6-8a84-bae500000037",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"salePrices": [
{
"value": 346347237000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 100,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/2b50da23-296b-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"updated": "2016-06-07 11:14:05",
"name": "Услуга, у которой мы придумали только имя",
"code": "pumpkin2",
"externalCode": "5fZe-Qyji8mSwoHYs7kSA2",
"archived": false,
"pathName": ""
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/f6ecdc65-2c86-11e6-8a84-bae500000027",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "f6ecdc65-2c86-11e6-8a84-bae500000027",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:20:40",
"name": "Доставка товара",
"description": "Доставка на дом выбранного товара",
"code": "delivery",
"externalCode": "deliveryCode",
"archived": false,
"pathName": "",
"vat": 11,
"effectiveVat": 11,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 7000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
]
}
]
Удалить Услугу
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Услуги. |
Запрос на удаление Услуги с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/service/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Услуги.
Метаданные Услуг
Метаданные Услуг
Запрос на получение метаданных Услуг. Результат - объект JSON, включающий в себя: + meta - Метаданные + attributes - коллекция всех существующих доп. полей Услуг в формате Метаданных
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Услуг
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/service/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Услуг.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "string",
"required": false
}
]
}
Отдельное доп. поле
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/3cd83619-5585-11e6-8a84-bae500000069",
"type": "attributemetadata",
"mediaType": "application/json"
},
"customEntityMeta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/a27aa372-5311-11e6-8a84-bae500000001",
"type": "customentitymetadata",
"mediaType": "application/json"
},
"id": "3cd83619-5585-11e6-8a84-bae500000069",
"name": "Связанная сущность",
"type": "customentity",
"required": false
}
Услуга
Отдельная Услуга, обращение к которой происходит по значению его id.
Получить Услугу
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Услуги. |
Запрос на получение Услуги с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/service/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Услуги.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/63e4fa87-2c87-11e6-8a84-bae500000030",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "63e4fa87-2c87-11e6-8a84-bae500000030",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:11:08",
"name": "Облицовка",
"description": "Облицовка доставляемого товара",
"code": "additionalprot",
"externalCode": "addProt",
"archived": false,
"pathName": "",
"vat": 6,
"effectiveVat": 6,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 1052,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 1020,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "counterpaerty",
"value": "ООО Компания"
}
]
}
Изменить Услугу
Обновить существующую Услугу. Типы цен в ценах продаж и дополнительные поля обновляются как элементы вложенных коллекций: + Если в текущем объекте у какого-то из доп. полей / типов цен нет значения, а в переданной коллекции оно есть - значение записывается в доп. поле / тип цены. + Если же у данного атрибута значение уже присутствует - оно перезаписывается на переданное. + Если у данного атрибута в составе объекта значение присутствует, однако оно отсутствует в передаваемой в теле запроса коллекции (не передаётся совсем), то значение атрибута объекта не изменяется.
При обновлении Услуги с указанным массивом штрихкодов для каждого штрихкода требуется указать к какому типу относится штрихкод. Например, чтобы создать штрихкод с типом Code 128, в массив штрихкодов должен быть добавлен JSON-объект с полем code128 со значением штрихкода.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Услуги. |
Пример запроса на обновление Услуги
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/service/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Доставка товара",
"description": "Доставка на дом выбранного товара",
"externalCode": "deliveryCode",
"vat": 11,
"effectiveVat": 11,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 7000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Услуги.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/f6ecdc65-2c86-11e6-8a84-bae500000027",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "f6ecdc65-2c86-11e6-8a84-bae500000027",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:20:40",
"name": "Доставка товара",
"description": "Доставка на дом выбранного товара",
"code": "delivery",
"externalCode": "deliveryCode",
"archived": false,
"pathName": "",
"vat": 11,
"effectiveVat": 11,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 7000,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
]
}
Пример запроса на изменение Услуги с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/service/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Облицовка груза",
"description": "Облицовка доставляемого груза",
"code": "additionalprotection",
"externalCode": "addProtection",
"productFolder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/238e806f-2c89-11e6-8a84-bae5000000a8",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
}
},
"vat": 6,
"effectiveVat": 6,
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 778,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 777,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
],
"attributes": [
{
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"value": true
},
{
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"value": "ООО Компания отдел доставки"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Услуги.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/63e4fa87-2c87-11e6-8a84-bae500000030",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
},
"id": "63e4fa87-2c87-11e6-8a84-bae500000030",
"accountId": "6270cd18-2c7f-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 11:26:11",
"name": "Облицовка груза",
"description": "Облицовка доставляемого груза",
"code": "additionalprotection",
"externalCode": "addProtection",
"archived": false,
"pathName": "Услуги компании",
"vat": 6,
"effectiveVat": 6,
"productFolder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/238e806f-2c89-11e6-8a84-bae5000000a8",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 778,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 777,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/6314188d-2c7f-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
}
],
"buyPrice": {
"value": 700,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.1/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.1/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"barcodes": [
{
"ean13": "34875834765872435"
},
{
"ean8": "234234234234"
},
{
"code128": "23423423452351"
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e54cd-2c80-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e54cd-2c80-11e6-8a84-bae50000009c",
"name": "Экспорт",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata/attributes/0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "0c2e5dc5-2c80-11e6-8a84-bae50000009d",
"name": "Изготовитель",
"type": "string",
"value": "ООО Компания отдел доставки"
}
]
}
Комплект
Комплекты
Средствами JSON API можно создавать и обновлять сведения о Комплектах, запрашивать списки Комплектов и сведения по отдельным Комплектам. Кодом сущности для Комплекта в составе JSON API является ключевое слово bundle.
Атрибуты сущности
- meta - Метаданные объекта
- id - ID Комплекта в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - name - Наименование Комплекта
Необходимое - description - Описание Комплекта
- code - Код Комплекта
- externalCode - Внешний код Комплекта
- archived - Отметка о том, добавлен ли Комплект в архив
- pathName - Наименование группы, в которую входит Комплект
Только для чтения - vat - НДС %
- effectiveVat - Реальный НДС %
Только для чтения - productFolder - Ссылка на группу Комплекта
- uom - Единицы измерения
- image - Изображение Комплекта
- minPrice - Минимальная цена
- salePrices - Цены продажи
- attributes - Коллекция доп. полей в формате Метаданных
- country - Ссылка на страну в формате Метаданных
- article - Артикул
- weight - Вес
- volume - Объём
- barcodes - Массив штрихкодов Комплекта
- overhead - Дополнительные расходы
- currency - Валюта доп расходов
- value - Значение доп расходов
- components - Компоненты Комплекта
Минимальная цена
- value - Значение цены
- currency - Ссылка на валюту в формате Метаданных
Компоненты Комплекта
Компоненты Комплекта - это список товаров/услуг/модификаций, который входят в состав комплекта. Компонентов у комплекта может быть от 1 до 50.
Объект компонента Комплекта содержит следующие поля:
+ id - ID компонента в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в компоненте. Максимальное количество знаков 12, округляется до 4х знаков после запятой.
+ assortment - Ссылка на товар/услугу/серию, которую представляет собой компонент.
Комплект как позиция документа
Комплект может выступать в роли позиции документа. Он также как и товары, услуги и модификации может быть передан в составе позиции в формате метаданных.
Вот некоторые ограничения, связанные с использованием комплектов как позиций:
+ Количество комплектов должно быть целым числом
+ Комплекты не могут быть позициями в следующих типах документов:
- Заказы поставщикам
- Счета поставщиков
- Приемки
- Возвраты поставщикам
- Выданные отчеты комиссионера
- Списания
- Оприходования
- Перемещения
- Инвентаризации
- Тех. карты
- Тех. операции
- Внутренние заказы
+ Комплект не может быть позицией отгрузки по комиссионному договору:
- нельзя добавить комплект в отгрузку по комиссионному договору
- нельзя установить комиссионный договор в отгрузке с комплектами
- нельзя изменить договор на комиссионный, если по нему есть отгрузки с комплектами
Атрибуты вложенных сущностей
Метаданные Комплектов
Метаданные Комплектов содержат информацию о дополнительных полях.
Посмотреть все созданные в основном интерфейсе доп. поля Комплектов, а также все типы цен можно с помощью запроса на получение метаданных Комплектов. Ответ - объект, со следующей структурой: + meta - Метаданные + attributes - коллекция всех существующих доп. полей Комплектов в формате Метаданных
Структуры объектов отдельных коллекций:
Штрих коды:
При создании штрихкода требуется описать объект с полем, являющимся форматом представления штрихкода в нижнем регистре, со строковым значением самого штрихкода. Наименование полей отдельного объекта, представляющего штрихкод:
- ean13 - штрихкод в формате EAN13, если требуется создать штрихкод в формате EAN13
- ean8 - штрихкод в формате EAN8, если требуется создать штрихкод в формате EAN8
- code128 - штрихкод в формате Code128, если требуется создать штрихкод в формате Code128
Изображение: структура и загрузка.
Структура поля image, которое вы получите при запросе Комплекта с изображением: + meta - Метаданные об изображении + title - Название изображения + filename - Имя файла + size - Размер файла в байтах + updated - Дата последнего изменения + miniature - Ссылка на миниатюру изображения в формате Метаданных + tiny - Ссылка на уменьшенное изображение в формате Метаданных
Загрузка
Для загрузки изображения нужно в теле запроса на создание или обновление Комплекта указать поле image со следующими атрибутами: + filename - имя файла с расширением. Например - "банан.png" + content - Изображение, закодированное в формате Base64.
Если в запросе на обновление не будет полей filename и content, то весь объект image, если он присутствует в Body, будет проигнорирован, т.к. сервер посчитает, что его обновление не требуется.
О работе с доп. полями Комплектов можно прочитать здесь
Получить список комплектов
Запрос на получение всех комплектов для данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой комплекты.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить список комплектов
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bundle"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка комплектов.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json"
},
"id": "c21646cf-ee08-11e6-8af5-581e00000023",
"accountId": "badae4a0-ee05-11e6-8af5-581e00000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/bb430a4e-ee05-11e6-8af5-581e0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/bade121f-ee05-11e6-8af5-581e00000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-02-08 17:13:26",
"name": "Комплект с товаром и услугой",
"code": "00003",
"externalCode": "iOzqxcTCiAK1-6-eAjVR12",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 0,
"currency": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/currency/bb724075-ee05-11e6-8af5-581e00000058",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean13": "2000000000039"
}
],
"components": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components",
"type": "bundlecomponent",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
]
}
Создать Комплект
Создать новый комплект.
Описание
Комплект создаётся на основе переданного объекта JSON,
который содержит представление нового Комплекта.
Результат - JSON представление созданного Комплекта. Для создания нового Комплекта
необходимо и достаточно указать в переданном объекте не пустое поле name и не пустое множество компонентов components.
Максимальное число компонентов в Комплекте - 50.
Пример наиболее полного по количеству полей запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/bundle"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Комплект с товаром и еще одним товаром",
"code": "00003",
"externalCode": "iOzqxcTCiAK1-6-eAjVR12",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 20,
"currency": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/currency/bb724075-ee05-11e6-8af5-581e00000058",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"components": [
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b9",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Комплекта.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json"
},
"id": "c21646cf-ee08-11e6-8af5-581e00000023",
"accountId": "badae4a0-ee05-11e6-8af5-581e00000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/bb430a4e-ee05-11e6-8af5-581e0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/bade121f-ee05-11e6-8af5-581e00000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-02-08 17:13:26",
"name": "Комплект с товаром и еще одним товаром",
"code": "00003",
"externalCode": "iOzqxcTCiAK1-6-eAjVR12",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 20,
"currency": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/currency/bb724075-ee05-11e6-8af5-581e00000058",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"components": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components",
"type": "bundlecomponent",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000c",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000c",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000d",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000d",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b9",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}
}
Пример запроса на создание Комплекта с загрузкой изображения
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/bundle"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Комплект с изображением",
"image": {
"filename": "birdimage.png",
"content": "iVBORw0KGgoAAAANSUhEUgAAASwAAAEsCAYAAAB5fY51AAAD7GlDQ1BpY2MAAHjajZTPbxRlGMc/u/POrAk4B1MBi8GJP4CQQrZgkAZBd7vLtlDLZtti25iY7ezb3bHT2fGd2fIjPXHRG6h/gIocPJh4MsFfES7AQQMJQUNsSEw4lPgjRBIuhtTDTHcHaMX39Mzzfp/v9/s875OBzOdV33fTFsx6oaqU8tb4xKSVuUGaZ1hDN2uqduDnyuUhgKrvuzxy7v1MCuDa9pXv//OsqcnAhtQTQLMW2LOQOga6a/sqBOMWsOdo6IeQeRboUuMTk5DJAl31KC4AXVNRPA50qdFKP2RcwLQb1Rpk5oGeqUS+nogjDwB0laQnlWNblVLeKqvmtOPKhN3HXP/PM+u2lvU2AWuDmZFDwFZIHWuogUocf2JXiyPAi5C67If5CrAZUn+0ZsZywDZIPzWtDoxF+PSrJxqjbwLrIF1zwsHROH/Cmxo+HNWmz8w0D1VizGU76J8Enof0zYYcHIr8aNRkoQj0gLap0RqI+bWDwdxIcZnnRKN/OOLR1DvVg2WgG7T3VbNyOPKsnZFuqRLxaxf9sBx70BY9d3go4hSmDIojy/mwMToQ1YrdoRqNa8XktHNgMMbP+255KPImzqpWZSzGXK2qYiniEX9Lbyzm1DfUqoVDwA7Q93MkVUXSZAqJjcd9LCqUyGPho2gyjYNLCYmHROGknmQGZxVcGYmK4w6ijsRjEYWDvQomUrgdY5pivciKXSIr9oohsU/sEX1Y4jXxutgvCiIr+sTedm05oW9R53ab511aSCwqHCF/uru1taN3Ur3t2FdO3XmguvmIZ7nsJzkBAmbayO3J/i/Nf7ehw3FdnHvr2tpL8xx+3Hz1W/qifl2/pd/QFzoI/Vd9QV/Qb5DDxaWOZBaJg4ckSDhI9nABl5AqLr/h0UzgHlCc9k53d27sK6fuyPeG7w1zsqeTzf6S/TN7Pftp9mz294emvOKUtI+0r7Tvta+1b7QfsbTz2gXtB+2i9qX2beKtVt+P9tuTS3Qr8VactcQ18+ZG8wWzYD5nvmQOdfjM9WavOWBuMQvmxva7JfWSvThM4LanurJWhBvDw+EoEkVAFReP4w/tf1wtNoleMfjQ1u4Re0XbpVE0CkYOy9hm9Bm9xkEj1/FnbDEKRp+xxSg+sHX2Kh3IBCrZ53amkATMoHCYQ+ISIEN5LATob/rHlVNvhNbObPYVK+f7rrQGPXtHj1V1XUs59UYYWEoGUs3J2g7GJyat6Bd9t0IKSK270smFb8C+v0C72slNtuCLANa/3Mlt7YanP4Zzu+2Wmov/+anUTxBM79oZfa3Ng35zaenuZsh8CPc/WFr658zS0v3PQFuA8+6/WQBxeNNNGxQAAAAGYktHRAD/AP8A/6C9p5MAAAAJcEhZcwAALiMAAC4jAXilP3YAADIqSURBVHja7d13nCVXfef9zzlVdWPnNEkjTR5JKI+EcgAkkW147F2C19jrB9Zrm/ygNU6wJjw2GJbFmGcND7vYeI2N13qwJUBaBSSRJJQT0uScU+ebquqc549T1d3Tmhn1jKZD3f69X6/WzLTu9NxbVfd7zzn1O+coa61FCCEyQM/2ExBCiKmSwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITJDAksIkRkSWEKIzJDAEkJkhgSWECIzJLCEEJkhgSWEyAwJLCFEZkhgCSEyQwJLCJEZElhCiMyQwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITJDAksIkRkSWEKIzJDAEkJkhgSWECIzJLCEEJkhgSWEyAwJLCFEZkhgCSEyQwJLCJEZElhCiMyQwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDH+2n4AQZ5pN/mMnfscCCtRJHj/5AeoEjxezR1lr7Sv/MULMLgukl7JW6qSPm+zlQslYl3Za0mvWSWCJzLIWLBYFqAkhNRhZRhuGwbph23DI/tGYgWrMaGgYbphjfwaQ9xStgaYYKHrLPme1+Cwue7TlPdpzmpwaf7QxJA0xhZIAm3HSJRSZ4lpS7vc6CY7Qwu6RiF8cbrBzsMHPDzV48mjIrtAwGFqIky/g+CljweBGdD0NPiz2Fee3+Ly6N895HT4ru/Kc1xXQFuhk4NeFl1JzP7iMpWlah9LCEpkRG4vnmlMYYOdIxFMH6ty/q8qjhxs8NhxBZEFDn6fIKwiUQuvk7pIiaY8dK/2Ota5bGVkIrWUgtowawEJPSXN1e8C1i/LcdFaRc7tztPsuuoyxoE7eFZ0Nxh7b+rRkf0xOAkvMaRYXCFq5N14ltjxxoMbdOyp8f3eNZwYjUNClFV2+wlOKCIixSZdx/OdMhZrwq1bgo9BANbbsjI1riQWKX+3LcevSIrcuK3NOi+uouOCa/bGuNHh18kQePVCjt+ixvC3AWuZ8i/BkJLDEnGWMdXfqlKIaW362t8rfvjjC3+2pQWzp8RSdvsIolyOxnXownQqVfHnKtdSMga2hC69z231+a2WJt64oc25nDnAtQT0LXcXJQbV9JOJbzw/xyR1Vtr6hj+XtQea7hxJYYs6x1rWOtFbEwCP7qvz1c8P8zz01MJZVgUZpRYSdtpA6GQ34CjxgOLLsCy1LWzw+uKbMu89vY3HRAyzGzkxra3JQ7alE/O9tFf56/QiP7avzyUta+c/X9TRFn3DeBJZN2sIZP19Nz1ibvMkVGwdD/sfzg3xuUwViy6qcBqVoWDvjIXUiHpBXMBJb9jQs67oCbruwlbeubKHkKddK1Gf+ukvLOCaOUe2tRHx/S4Wvbxzh8f6Qpb5il4aHXtfDDUtKmW9dwTwIrLQo0J3TmfvUE6cuNhZPK6rG8r/WD/O7Tw0xWo1ZkdMoDeEstKamSuOC60BoGYwtv352kT+8osN1E63FnKE6LpPe7MSOBdXmwZB7to/yN5srPHY0pMVXnJ3TvNAwvGNhjm/euoCi5/5W1jV1YLlGlWUgtNy+eZRfWVmmI6eTT/Hsn7xmkdZTaaXYMRLxF4/389UtFZb4irKnqM3hoJosUBAAG+qGs0sef3ZZO+9c24rGjbF5p3HZ2bFC/fGQioHnD9e5Z3uF/75llA3DMd2+ottXhCgCLBtrhu9c38W/XduKMaCbYCJeU9dhuaJCxSN7q7z3R0fYNxxx2xUd5CHzd0uaRTqsopTiZ/tqfOAnR3hyMGJtQVO3UM1KUiVCCyGwOq+pNAy/9pOjvHi4wcde3Ul7MPUPS2uT7rFWE6YIKQ5UYx7fX+POLaN8bV8N6oaFgXbHC3e8AmXZGFpu6clx87Ky+5tNcq03bWBZXH99MDR884VhyoHiT54fprfk8dsXtCXTOGRMazYZCzrpr//DhmHe/fMBiC1rC5pKxoJqspqFQCvW5BSfeWGYjQMhn72+m1VtwXFDa6wEw47fGfWSxwyHhqcP1Xl4d5Vv76y6Ug5gWaAICj4h9pjjFaAgNvyf57XQldeuLKRJxkGatkuYXhTf2zbKWx84zJqcJjawJbbc9bpu3nB2eWzMRMy8iYPrf/nUAB96cpBlgcbXipq1aLLTDTwZBZS0Yn0tZl2Hzzdu7OGSnjxxUrKRPkZNCrADtZjt/Q0e3lvjjp1VHhiKoGHpCxRtvkLhbj6YSf9eTsGWhuGXenP87RsW0BHopupNNGVgpf39kRjef99B/nZ3jZV5jUVRiQzkFHfc3MsVfYWm+vTJCpMEEkrx5acG+PDjg6wpahq4cR5Fc4RVygJlrdhQj1lV8vjH1/Wyrjd/zGOONgxHRyNe7A95eG+Vxw41uG8wgtBSChQLPEVOKepYjD3xJO4csDmy3PWabt6wrNx013dTBlZ6kn6+v8ZVdx9kpacISSa6KsXu0LCs7PEPr3Wfds12UueyNKxsElYfeWKA1QWPRjKdr5kVFOwIDctKHt+8oZu2vMeTB2rsGwj56ZGQO/tDqCdHwVOs9hUoV29mpnB8igo21gwfP7fMZ67rwbMW22SlPE0ZWNa6uymf+flR/uS5YVYXPGpJzYrBndg9oWVVi8c/3tLLeR056R7OgIljVl9+eoAPPzHImrwbXG/2sEpbjTkF/ZElpyGnFDvTydmeYlmg8JWbChTh5jRO9c0ZKDiUXNO3v6GP5a3Zr2o/nia40XmstL++rxpz/64qgaeIk9NukxdctXBWoHh2KOLDPz7KjtEYTyti03TZPWekA8ooxd+9OOS6gfMkrMZeP9Cw0O4pAqWILazJKdYWPVbk3ITuhrVUrT2lmjMFeBaGjeU/r+twYWVs04UVNGNgJSNYzx2o8+BwzLJAEdmJ/388tNbkNfccrPP+Bw+xfSSS0JpGabf7/t1V3vPzAZbl9LzoBh5PxPj0npqFyoSAOp2rr6RgU93wqQtaefOKsrvT2IxpRRMGlsYV1T26v0aaVJMvgvTPVQtr85rv7a/zgYeOsFNaWtMituBpxeahkNsePko3btmpeLaf2CwyydfpXmlpF7OoYH3N8K6lBd5/aQcerqq+OeOqyQLLlVYp+msx9+6r0R5oopf5O6NjoVXj/Q8eltA6w4wFT1lGYsunH+nnqaGIbl/RsM0wUWR2TByL3dgw3NAd8NlruulMSnem0riyuBsgWbvKmyuwksO/fTjiheGIdm987tWJKKCShNad+2v8zgOH2DQk3cMzJinQ/fYLQ3xrR5Vz83qsel2O7qlLw6qg4GhoWFD0+NL13Sxv9ad04yhdX4ykTlExvoJrFjRVYKWePVTncGQpqKm/KSrJmNYPDtb5tXsP8kJ/Q0LrFTLJEjEv9Df41HNDLMm5eYHi9KUtq6OhweY9vnNjN5clhagnK80xdnwFUq0VsVI8daTBwWqMOoX3yWxrqsBKT9eBgRCMm3hzKieiYmFNTvPYYMiv33+YJw7V8bRbIiQrJ3SucDc3LA1j+aunBthTNZQ8Na/HrV4pixtg39kw+HmPf31NNzcuLo7d0FCTHpuGFMmsAq0U/aHhR/uqfPCBQ3zl+UFypzMbexY1zVzCtJxhMDI8MxCCdrUsp0LhBuJX5zS/GI54472H+Pvru7hlaQlsMpU6W+d31qS1cPdtG+G/ba+yOudKGMTpUbiw2lA3XNTu8//e0M2r+wpjLau0a2eTcSlPpdN9FKOxZdNAg4f3VvnBjirfO1inL+/x8FsXZG71kuYJLFyLaqAW8+RozOLT/DRPQ2tpoKmEhlt/eJjvXNPFr6xucXdgZD2tl2WTgsWBhuGvnh92m0aobI2VzCUebsrNhlrMmxYW+MJ13ZzXERAZmwTV+EJ+6ZzEkdiyY6jBs4ca3L+7wj37G+yqxHQlfaq/ua6LFW1B5gqmmyawUpW6YVPVsEyrlx1wP550uZO6tRQ8xTJjecePj/KFkYjfu7idgobYuNvy4vjS1tUPd4xw18FGU6y+MFtyCkYiy/bQ8MG1Lfz+FZ0sLnrExuKnWwEBVWMZaRg2DzR4fF+dpw/X+d6BOgdrrrpria+4uOTxTCXmzy5u443nlJLi0uyEFTRVYLmoiSMDDYNX0KcVWBOFSf3QSt/ysScG2TkU8omruujOe7O20cBcZ3GDuoOh4W/Wj4BWL1taIo5PWcuWumVtSfOlq7t559pWFMnKq0pxpBazcSBk52DI44ca/PxgnZ+NxlCLQSnOChSrcgqjNAGWZ6ox71xa4D9e0p78A9lbxaF5AitpGu0YdR3BM3Ue4uTiWJtX/OXGUXaOxHz6mm4u6Ayw1ibztTJ21qdROpb4+L4adx4KWR0oGbs6Rclq3sRK8d7lBf7dhW0sawn4xZEGu4ZDnu8P2dwfsnU44pGRmJFKDBo6tWKZhlzRxyRzEetADsve0HJxm8+fXtVFR5DdNbKaJ7ASVXPmJ3sYoAKsLXr8y/46z9xzkL+6soM3LSu7upgMDVpON63cBIPbt4y4DZWVognn1087Yy05X2M8xXeeH+JnR0OeGY2ZOM+sqBR9vmJx0XPbnCW7CFUnHG8faBgY9hVfva6LNe3ZG7eaqHkCKzn+Qw2b/FFxposRKhZW5TWDlZg3P3CYL10S8psXtNMRqGPu1sxX6eoAG/obfHdPnSW+IpKwOmVuwoYiiiz/Y3MFLHT6iuUeeDmd7GCdTO+xUDtBxbrGvcG3hZZ/ur6LaxcVMzluNfk1NYX0FBysTF+ljxuMh1ZfscJTfOSJQT704CG2Dod4WmGNdXUv85Z77T/dVWF/zdDizc/JzWdEsnvr8oLHqqJHR6AwStHArfjQsK6xdaL5iApXDb+pbvjipa38mzUtye5R2R53bZrASk3nyUgvjBCIlGJtQfOtHVXefvdB7tpRQWuFVvOzOt6toa8YCg337q0ldXAZfmfMEZG11K09JpymcnWVFGyoxvzpha184LJOwGIzOMg+WdMEVnoS23Iz85Isrou4uqDZPhLzph8e5s8fPcqBmps87Qbk509wpS9133DIPx9ssNzXhPPo9c8lZQXrqzG/u6rExy7vJACMbY7hiqYJrDSxet2OkckWX9NL4dYz6gkUKz3FHzwzxDvuPsAj+2so5VpbZp61th4/1IDQSp3aLCkny828b0WJz17X46ZDNdFifk13Wc3keRnrIloIlbuL+NDRkKvvOcQXnxjgcC1Gj7W2ZvvITK901uZzB+sATbPrTZa4lpXhnUsL/Pn1PXQEOtN3BI+neQIrOSdLS2kLa2ZPUtpFXBlolmH52JMDvOPuA9y/q5K0ttwdnWbsJaV3tQZCw+ZkHqdpig5IdqQtq99YVuS/3tBDV675wgqaKbCSN0hrToOvZmX8SAENkkLToscP+yNuvv8wn37kKDtHQnQy6JnFhdNOJj3Uu0cifjIac5anTnniuTg96aTo9VXDe5cX+dKNPSxIpu40W1hBUwWWkws0CwqayMz8ipbpW9Qw3tpa5Sk+8fwwb/z+Qb69fpjROF04rfkG5YdHIg6MxJS905vHKU6NBgrAhprhA2tK/MUNPW7VUducYZW+5qaQnp72gselZZ8jxjLbS/00rKUBrCl4HKwafu0nR/mNuw/w0O4KMW5QvjnuJrrnv68Sg5357vh8kh5ZH7eCw8a64U8vbOXzyZiVW5K6eY9/0wRWuiBQR15zYYtHJbZzoozf4qZKtPqwtqC5/UCDm+47zO//6DDPHWmM3U3McnBp3BZVm0YiUGDO+BwDkUr3NmwYy6bQ8MV17Xz81V1jq4g0acNqTNMEVrrWtQ+s6AzcTPQ59Ekf2WRqT86VQHxx0ygX/eAAn3r4CBsHw0nBNdvP9hQpV+C4txKPTRsR06OoYFfDsMdTfPfGbj58aQc55eqs5kMpSVO+xFU9OfAUDTv3Oid16yrlV+c1Z1v45PMj3Pz9A3zusX7WD4RjdxTTFldWGl2xgYNVI4E1TTRucH1j3XBxu89jt/bytpUtKGuxtnnqrKZyHJpGslAsazsCLi1qRszcfIEWV3CqFKwpakxo+PgzQ7zpBwf4/OP9bBgMsUmLSym3y8mcb3VZCOO5/iSzSWExxrKhanjP2UW+fUsfl/cVkqLk8VVG54O5+H4+fcnukj0ln6sX5DkUmVkfeD8Zg1uOOdCKNQVNIzT8/tNDvPn7B/jjnx7h0YM1qskqEFq5Fpc5hS3MZ/S1WMtgxS0cNxefX1YpQFvFQa34r1e08/+8tpdVydLG83EByaYKLLc2FRS14sZFBcCthz3Xxbjg8rVidUEzGhr+7IURrrz7IB9+4BB37ahwqO4uUJ3cXJiLra559t6ZEXml2N4wfPLcMh+6pIOy51rcnlbz8oDPhRtpZ1ZyEi9YUGBF0WMoNBR0NraXMriuYkErVhcVkYGvb6/x9Z013tKb4+3LS1y3tMjytoAgeZ3pnUU1B3b0ycp4W5ZoAAvdBffR6/YTmIdJlWi6wFLKbc+yut3njQvzfHVbhVV5RZaGV2Lc0sxKwaq8wlq495DbVGDVs4O8bWmRW84ucdnCAt05nWT0eItLqdm5P+o33dU0+9LLNkpO7mx/KM22puoSwni3MFCKt6wojX0viyzjdxUXB5rVec1Iw/KFF0d5/f2H+bc/OMAXnxzgZwdqHB7rMqqxQVq3kebMPFetFe1FD+bgndksU2O/ylGFJmxhAcnHkOXShQVu6s7xeH9IX6AIM9TKmsji6rgixruLxsJj/Q0eONyA54d4e0+O6xcXuHZxkRUdAT1j64JZsAqT7tw4TUMfCsjN466KmBlNGVhagTGwoODx7lVlHvx5P4tRhLP9xM6Ase4i0BtoFgVueZvv7q/z3X11eHaIX+rJce2CPOsWFji/K0d7XlOaECbWMlaLrlyF7SsOMd+DRWXPLcM72wdJNK2mDCxgrLN/y7ISl744zJ5KTCkjg+9TMbHVpYEVOY0GQgN37K9zx+4a5Ie5pORx/YI8Vy7Is7IjYHVnjrZAExwzGGIxhiRpVPrLlIPHJvPXFpX0WGAlFSZCnFFNG1g6Kbhc1uLze+e38t5H+lmTV1Sb8F2U7p6Svu6VOQ8vZ4kM7BmJ+crQKF/ZMEJXyeOaNp/zugIu7Suwuj2gu+SxsORRPEF37tj5jccPM4sLzVe1BWAtnsSVmCZNG1jAWCvrLStbuGnjCI8ORCzM8FjWVBjcKhHpyy8HinY0Gksthu8dCvnegQZsGAVPcUWrzyUdPivbAha3BZzb4bOkxSfwNOVAHdOVHGexNvl+Mo0IpWjJa/B1Zidxi7mvqQMrbWUtKGg+dFEbb3/wCH6TjGVNhcWNd8XJgi9Kua6jwm2DHlvYMhTx2NEQTAV8Bb5mZU6xttVnRavPBe0BHQVNW9Gjp+TRW9B05j0C7Y6vRo3tILyoM8fFrR67R2LafDVxz08hzoimDiwA5UrDuXVZmfcur/CNrVVWFzS1efZmSreHGi80dQHW7iu6fDV2oyI0UKkZ7qs0aOyruyabAnKKs3KaRTlFT6Bp9TWdJU1bzqOvqCn7is6CR5eGjRbaZvsFN4nxRSHn2QV7As0fWLhWRslTfOjSDh482GC0bsh52SomPdPGA8wN3I8Nlms3HeQsQKPxkjdKaKHRsGytGx4z0UuHqFzVBAt9Ra8nraszIb15ATO3fd1c1/SBBe4OljGWCzpzfO6KDn7loSOs0YoaMjQ80dgmnZbkbup4awzA86ANNyY2cV3R9FebFLnKMT2T3NHM68lHe36aN7Gt3CJTvGVFC/9pbQsba4aSrN00Jce0xiyE1roW16Sv+TI2OJMsgJrf8wcnmj+Bhdt6KqcsH7u8kzcvyrO+bkhKh+b559YrYyd9iTMnStZEbinMm7fqSTXdUTjZHfV0b8DevObLN3RzVWfA9oYLrbG6SSHmiHT8NacVBb/p3qqnpemOQrJYwwkn/Wrltu5e2Rbwleu7act57KkbikpCS8wtSrnu91JfjQ26z/frs6kCy1g4XI1RimRd9OMHl6ddaF3em+dfXttDMa85GlqKSkloiTlDAVUDfTlNl3QJgaYKLIvB8ic/PsyXnuhnz2g0Ibheurywp93u0NcuKvAvr+tB5zWbGoZy0tISYrYpFP3G0pfTdOc9wMp6WLP9BM4Y67p7YcPw0UcH+eW7DvCFx/tZP9CAZJ0orVyFd7objUrKHa5dWOSum3tY1+qxoWZome9XhZhTWvx0JyW5LpsnsNIXpICC5kjFcNvTQ9z6/QN8+IFDfG/bKHsr0TG70aTV3lFsWNdX4Nu39HJTb4711Zh8Mx4ckSlpPPW2+FLWkGiqwlENFAs+mAb5nGZNwWMkMvzl1gp/uaXCFZ0Bb1yQ4/wFBS7vy9NT8mgNNH6ytc6ajhz//IYF/MVj/XxuwwiLfEVOK+kiihnnqtzdAMZZLR6+LIABNFFgpbVUQbI7g7FQs5acVqzOu+9tH474VH8IGyucl1es7gx4dXfAue05Oso+vWXNkhafj1/dxfk9AX/05BAmMmgloSVmQRJQK1t9PNx8wvm+VHLTBFaqs6iP+SRKV+gE3ATdQGEN9Mdwx4EGd+ytu8cHirNzmmWBYnGg6GsL6AkU+0PIz+9rRMyyhaUsbFY3M5omsJIlmTi7NUi/85LHxNbt/6eAgoIVgUIHbq0oY6EaWh5uGEIDHA5ZHEiXUMwOraAWW3qKHuV8Gljyydk0gZVa1epeUlpPdbxuv2Viy2t8gm+gYalSyWC7pmGtDBuIWaGBfgOXlz3aC1I0mmqewEpKEXpKHhQ0kUmq3qf4148NsfQ7QswOD8VoZLi4zWdJycNa6/bcnOea5s59eipbix43tvoMxha5EyyyKr10+0oe3tj9QtE0geX6f5a+gsc17T4DsSV4xT9UiJnnNgO24CmWtMtVPFHTBJZbPsa9oJU9ubGPKGlkiSyKLODBBV1pYMmVDE0UWBOtW1jgrLymYuQ0i+xRChrGsizvjZU0yHXsNFVgqWSL+mVtARd2BByRcSyRQT6KvbHlup6A1mTSsySW01yBhavH6shp3ri4QDW2k3Y4FmLu8wFiy5VdOdoDjZG8GtNUgQXjxQjXnFWEvKYem+Z7kaJpjQ24B5rF7f6E7wpowsBSyZKj5/Xk+I0FOXaE0soS2aGBodjyqpLmvO4cIHE1UfMFFm7ic0kr3rKi7NbJmu0nJcQUaQUHDKxt9TmnxUcW7TtWU76X04rga5cUuabT52Bo3PIcQsxxGsBa1vXlyftaFu2bpEkDyy2LvKjo8eurW6SIVGSCAlQyCHt1Xx53f1Bq3CdqysBy3CfTm1aWuaYz4EhkpZUl5jStYDi2rGn1WdwuBaPH07SBpZS723J22ec/vqqVI9LKEnNcgGJ/ZLmpM2BZm4+1Ukc4WdMGFpCszmh5y4oyb1uUZ2PDyGJ8Yk5yl6UruLpsYZ68kgnPx9PcgaXAGOjMaT5wUTto5Rb6m+0nJsRxRAbwFNcuKiTfkSt1sqYOLACV7Kh601lFPnFumS3JLs8gl4OYO3yl2BUZ3tqbY0mbG7yQcoaXav7AAgxuFdH3XdTBzb05NjQMuVNY3E+I6ZbDEkWW1y7M05nTbsG+2X5Sc1DTBxa4uy/GWs4qefzplZ3ga8LYIkv7i7lAAzUDFDSXLHTdQYmr45sXgQVuV2hjLNcsLPDfL+9gZ2jJId1CMfu0gn2x5eb2gMv68mPfEy81bwILxucZvuf8Vj55YSsbazEluTDELPNR1CPLL59doC3QWBmrOKF5FlhuVVIfy8cu7+T9a8qsr8SUJbTELNFAbCzkFdcuKQIytnoy8yqwIOkaWmjxFJ+8qovfWFFkfTWmRUJLzIJAKbZGhn/Xm2dNdw6sTHY+mXkXWOBCKzaWnrzH56/r4V1nF3lx1LW05FoRM0lhwcBNS4uUPY2Z95vRn9y8DCwAT7vQ6it4fPnGHt6/tsz6akxhwkGRC0dMJw3UY0t3SfOapYVX/PPmg3kbWDAeWr0Fj8/f0MMnL2pjY93gWSt1WmLa5ZViZ2h579Ii57RLd3Aq5nVgwXhoFbXi96/o5Cuv7mCrhV0NVxEv14+YDgqIrQUPbjmnhAfSHZyCeR9Y4ELLWCgo+L2L2vnxrX1c3hmwsWrIAYFcReIM8xRsiSy/3JvjqsWuOyitq5cngZVIC/WstVy3qMA/3NrHH76qhc2RZW/DUFLIelrijMkBxJZ3rWqh7MvOOFOlrJUytYksYIx1XUXg3p0Vvvj0IPcdaNDjKzoDRYhbN14OnDgdgYIjkWVlyeOONy9gSdnHWKlunwppYU2iSLuIFm0tbzi7xN+/fgFfu7qTpS0em2qGkciSV66GRq4xcap8YDC0vGt5yYWVkYX6pkpaWCdhrVtTWyeDCztGI+7cPMrfbhrh8cEItGKFr/AUxEDsSmqEOCG3yQTsULDhLQtY05mT1tUpkMCaAmMBa9F6PLge3Fnl9i2j3HmkAQ0Dvma5p/C1IsLdAZIDKyYrKsXGeswfrC3zmet60NZipaU+ZRJYE9hkXErh/qOO9/8nBNfR0PD8oTo/3Vvjf++s8tBQBKEbPV0cKDz52BQTKMADthl45PW9XLmw4IYe5PbglElgnYSxY/F1jPSQeYqxe9GDoWFjf8imo3UeO9Tg/v11jlZiPC1rcwsnr2Bz3fDhlWU+f2O32xRFwuqU+LP9BOaCNJbWH20wGln6Wjy68h5l7wQX04SLLLSWgYZluGEoKFhY9mEgohrLQKoYp4HIAr7iHee2EKjkxs5sP7GMkcDCdfWUgp/sr/G+Rwd4TafPWQWP3pwm7ynaSh5+soFF2lUcqcXUQ8NwZNlRNTxbidk5Ermr0lMs8RVadj4RiZyCTTXDB1eWWLewkEzDkU+0UyWBxXin743nlFjxzBA/PRzSIEqKrU5wC2dswEuBp1ioYWWg0Tk3jGWQOi3hKJIbN77inee1EuCuD2ldnToJLMa3tl9Q8njXsiKf/cUIF5Q0jSRxjjfM54avFAZ3McZYQstYSklYiVRewaa64UMrS6xbIK2rV0JCPmFR+Epx6zklCBSjkaVmLFVjqVle8lW1UDHuMQ1riZMG14TMEgKNq3rpyGvec0EbuWTVW4mr0yOBlXC9PsurFxb4tYV5toUGXz4FxSuUU7AjNHxoVZmLe/Kunk+uq9MmgTWBsYqCVrxrTQso8GRvOPEKeMBQZFlR8njXea1jS8iI0yeBNUH6wXfD0hK/sijPpoYhJ5+G4jTlFByILB97VQtr2wOZM3gGSGBNoABjoNVXfPDCNlfCIHW14jQEwO7Q8treHP/Hmlb3Tfnwe8UksCZRGrCWq5YU+Z3lJTbVDUW50MQpULg3VsVa3n9BKwsKXjIFZ7afWfZJYE2S1szklOK3L2qjXPSoxUYOlJiyvILNDcP7l5d40/KyK2OQsaszQt6Hx6G129b+4u48X7usjZ2hm3YDcjtanJwHjMaWc4oe77u4nbxWbq12uXDOCAmsE0gL+962ppV3n11kQ81Q0krWuxInlVOwt2G57YJWLurKyUD7GSaBdQJKudUayp7iU1d2sbrF41BoyMnFJ04gp2Bjw/DmRXneeW4rIAu1n2kSWCeR7hC9sj3gr6/t4mgywCUHTUymwW0XF2j+8PIOunM6WUlUEutMkvfey9DJKg2vXVri6+s62NqwFJAPTuGk10Fewfa65dOvauHqhQWszBecFhJYLyNdfRQL77ugjc9c1MqGakxZrkWBmzeaV7Cxbvg3S/P85gXt6eUiH2rTQAJrChTp5hKWj13RyR9d0MqLSWjJRTm/eQrqsaVc0Ny2rtN1BY3MF5wuElhTpJWrz8or+OOru/ijV7WyvhJTVHIQ57OchV2h5cuXtnNFbx5jpCs4neS9dgq0Gt/S/k+u7uKTF7WxoWYIsGO7Qsul2vzSc1xMuoIfWVvm3ee2JutcyQyc6SSbUJyGdJpFjOJrzwzye08NskRByVPU5GjOC3kFuxqGyzsCvv36Ps4u+7IDzgyQFtZpcC0thYfldy9u57s3dFPzFZvqhpKMazU9DwhjS91T/PnVXZxd9oll3GpGSGCdJjempbDW8rYVZe59fR9vXpBnQ83gJ2Ndovko3EoMO2LLN6/o4LpFBRlkn0HSJXyFJm6ueqRh+Mazg3z8F8MQW9bkNBFuUwqRbWmpQknBhprhExe08sdXdREkO3zLQPvMkMA6Q2Jj8bRbG/4n+2p88akB/nVfnaJWLA0UoYUYWe89i9KylnISVm9fkufrr+ujJy1hkMmCM0YC6wwyFhTutnZ/aPj+llG+8eIwDx0J6fAVvb6bPB1aCa6sSFtW6ZIxl7UH/NMtvaxsC5IPKQmrmSSBdYZZki5i0kXYV425e+sof7dxlAeONkAl+xcmu6dIeM19ATBqLF6gufPmXi7ry0tYzRIJrGliXHKNdRf2VmMe2lnh9s2j3H6oMbZD9Epf4WlFZK3btxXZKmwu8YHIWHZZuPs1Pbz+nBJx8oEkcTXzJLCm2eTgGgwN6480uH9nhQf31Lh3OIa6AU/R6SnatOt+aMAoRWzBJPEVS2tsRimggFsy5lvXdPLr57W5SnYtYTVbJLBmiLEA6WJu7nI/VDdsPtpg/aE69+yvs3Ug5OmaoREZN0IP4Ck6tNu8tV1DXisJrRmggBKwvm74L+va+cilHWAtVlpWs0oCa4alwZVudZ+qxJaResymoYhtAw2GR2L2jEZsrhl2VGPKWtFfNxyoxnhKQms6Kdy0mw01w59d3MZtV3S6PQUtsnroLJPAmkXWgh0LL5hcI2+A4dDiKcvuSsynf97Pt/fUWOErqe2aRq1a8UIl4g/ObeH/vr4HkLCaKySw5oik4YVN2k7GWHztZtJuGQz59MNH+Pt9DZb6imi2n2wTa1GKF2sxH11d4rPX9VDwlITVHCKBNcdYwCbFiCFw+4Zh/q8nBtlbiVme1xJW06isFOtrMR9ZXeLT1/ZQ9iWs5hoJrDlk4mz/nSMRX35igP+yeZQlvpKVIKZZWcH6quGja0p85rpuip6WsJqDJLDmgIkV8hVj+f7mUT7z9CDPDkWszmtC5UoaxJmngSKwvmH46Koyn762i5KvZamYOUoCaxZNnDgN8NyRBl99ZpCvbavQ6ys6fUXNSO3VdPEA31o21w2fvaSdj6zroKilGziXSWDNgsnFpLtGI/7X+hH+8MVh6g3DmpwmtMh41TRI5wb6yZZt20LLFy5t50OXtePjlgySsJq7JLBmkLUWaxkLqqOh4Z5to3zh2SGe6I9YmtfkNdTljEyLdNWFgoJabNlt4ZtXdvCb57UBVvYRzAAJrBlgXMEVWgMoBkLDgzur/M36Yf51f50uT9HjK+o23Z1HTJeigm0NQ+gr/vX6bn5peRmsxSBhlQUSWNMotqCsHQuqIw3DAzsr/P2GEf5lv1u5YXVOEUn3b0aUFGyoGy5u9/lv13W7DU/dHQ9ZgC8jJLDOMGvt2KBt+ibYU4l4aHeNf9w4wp0H6qBgVaAxyi3aICdgeqTjVR6Qx4XVry7J8+fXdrOyLRjbkkuyKjsksM4Aa123TzE+PtUAtgyE3LdjlNu3VnjoaAhasTqQRfxmUk5BFFt2hJaPntvCH1zRSU9ej20aIWGVLRJYp8kmy74oGFuBwQCH6zGP7atx364qd+yusXU0psNT9AaKGFnffSYVFextGEZ8zTfWtfPu89ooamTxvQyTwJqipBJhbLJyOkBrgKHQ8MyhOg/vrXHX7io/OhpCDItzirLn5v7JWlYzx8OtKbahZrimK+DzV3dy7aKiDK43AQmsEzBjR+WlFc8hsK8Ss2co5P6dVR47VOeOIyHUDe2+u+OnNYQTlrUSMyOfliyElt9ZVeK2yztZ3uIn41UyuJ51mQssaxlbheV0L70JWZT83h7z8yYv9VIzlsGGYe9IxNMHG/ziSJ2fHWrw8FA0NmdmeaAJtAszaU3NnHRgXePqqzY0DF15zRcva+ed57ZSUErGq5pIZgLLWl56wSV35KZ0JVp3+9pVGBz/8RFu/W5jYcdIxPaBkIOjEc8ebfCzgw0eGU2WMzaWjkDT5bmWlIFkKWMxGwoKGgZ2NAy/elaeT7y6iwu7ckgxaPPJRGCljaqBhmHbUEhvyaM971H0FP4p/qwIqEaWodBQCQ0jDUMUWfZXI57vj9g1FLJvJGZLNea50diNkmvo0opWrch54z9HWlKzywMCBZtqBvKaL1/UyrvOa6M32S8QJWHVbE71/T6L3NJ2d+2u8U/bK6zMKc4qebT4Cj/ZrKGc07QWPFdZjrtYa6FhsBajFYSxZTA0DEWW/XXLgbrhuVrSappkgadY6Sl8XxMDcfJpXZeQmnUK16oajC3bI8u/P6fI71zSzhW9eQDpAjaxTLSwYLxLGGN5ZG+Nzz0+wJ27auApN5PV4K5kzXiipAMcsT12gEqBpxVdGkpKESj3WJuMXVlcyUI68J6JAzQPKFxdlbWwpW64uM3nP13cxttWt1DSKmlVyeTlZpaZwIJj19Ueiix3bh7hq78Y5uHBiFWBougpaualL8flkPuLybQ+TNJiM5NaTJk5GPNMoFwXcFOyJdptq0r89kXtrGwLxsYyZfut5pepwIIkbCYU/u2txHz7hSE+t36EwzXDirzGU9J1axa+cjsv7wotVQvvWZLnfRe2cfXiYrKTjRvhlFbV/JC5wEqlRZzpoOrzRxp8Z8Mwn9lcgYZhVV6jFDTk7l0mBUlQHYws/bHl9b05fvv8Vl6/okxJu36hRcap5pvMBlZq4vLCFnhkX5VvvTDCX++qQmRZkdOuiFOCa85TuCHJHLAnsoyElks6fD58fitvXd1CV84NULqhKun+zUeZD6yUsXasxiq0licP1PmfLw7zVztdcJ0daIrJDsoSXHNPoBQ+loORZSCyXNXh8x/ObeENK1pYVHK1JLK6gmiawEq5zQMA3GTjx/ZX+aeNo3xjR5XhmmFpzg3Ox7hga6oXnzEad9cPYFPDLV5/XUfAv19T5s2rWlhQTILKWpR0/wRNGFiQTlS2aFwJgwWeO1znnzeM8LUdVQ6OxuAr1viKSEmV+kxKV7cIcLMKtjVcycmtvTl+a02ZW5aX6cqPt6ikTEFM1JSBlUpXWJh4wW8bCvnB1lH+v20Vfng0BBjrLjaQ6vXp4mqoFNpaDsau20dO8R+WFHjbijJXLSnSmdPA+MRzCSoxWVMH1kTGpvMI3Z+P1GMe3VvjO5tHuX1/nZFaTKev6fIVnoIIRSRdxlfEdflc9W7DwI7QtWOv7Ah4x/Iir1la4lW9eYLk8cZaGUwXJzVvAis1viGEe1vUYssLRxv8ZFeVf9xe4eGBCIyl5CnO8hWxGp/cPK8O1GlIu3saV+QZGsv2RnLgipr3Lc5z81lFblxaGhufcmtUuZCSMSrxcuZdYKXGNjGd8E45Uot59lCD+3ZV+PGBOj8+GoKFFk+xIJmz2Ehuq1skwGA8pHwUHpbh2LI3ti7hix6/1Zfj8oUFXre0yNL2gKJOZxy41qu0qMSpmLeBNdHkjU0BdlciNh1pcO/uKj/aV+enQxE0DOVA0+O5+YdaHbtqQ7MfyPTouEFzhcISGqgay/4oWRes7LGuI+Ct5xS5pC/Pmq4chQnHVSYmi1dCAmuCtHoexpcliYHDtZgnD9TYcLjBXfvq3NPfcJWokaXoaxb57k6WVcdOnM76gZ3YxVOASl7QSDweUPiKNSWPNy7Mc3lvjgv7CqzpCCh6aSKlk8hVOu9ciNMmgXUC4+u3H9saOFI37BuNeOpQnV8cbPDo0QYPDEQQjRdG9HmKVk8li0i4ejCDHZt4DXMnzNSEX5UCjUrGoFzQVIxlz8QBPAVrWnxu6g5Y3Rlw1aICK9sDOgreWHfPHb/xqTMSUuJMkcCagrQ84njru++qxBwejdg6GPKz/TV2DEVsGo15djR2y2AmTZRepShoV9Ht6fG1xY0dXzli/N85fqCd7ESpl/m+Cw6FTkI4zRZjLcZAaC0NC4PW3YjAWPAV55Q8zi96nNPuc3lfnvM7A7pKPue0+RQmHYvYHvuzhTjTJLBOUZJbY2vBTwywhnV3xnaNRGwdCDlaidg0FPJcf8TW4YgtdcNIlAxIx8k6qhrQih4NReVKKtLe1Eve9y8XBPalvzW47GkYS81Cf7qmTlrslPyDHYFmsa84u+xxYWfA2naf3rLP4taAlW0+JV+Rn5hEyQ40yB0+MYMksF4hOyG8XPdxwi4ZuEH5oYahEVuO1mK2DUfsH4k4UokZrBv21WL2VWP21Qy7a4YjE8vuJ+64MZXTNDE1junrwYq8pien6StoFhY0iwoebTlNV9lnYdljVZtPW87D8xRtOUV+UgLZY2rSpKsnZocE1jQwE5phemK16nGMxJbh0DAaWqqhwRhLJbJExrK/EjMcGgKtGG4YDlWNG9xnfDFVlfx75UDRW/LGll1ZXPIoBYq8p8h5mrynyPuKUqBoDbRbouVEkm6qI108MXdIYM2AY7uR4384lX3yLCff41DhijWnytgJo+gTfyctJzGHSWDNMjvpN/bY75K2pdTY70/2s050KicUZ0ogiQyTwBJCZIae7ScghBBTJYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITJDAksIkRkSWEKIzJDAEkJkhgSWECIzJLCEEJkhgSWEyAwJLCFEZkhgCSEyQwJLCJEZElhCiMyQwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITJDAksIkRkSWEKIzJDAEkJkhgSWECIzJLCEEJkhgSWEyAwJLCFEZkhgCSEyQwJLCJEZElhCiMyQwBJCZIYElhAiMySwhBCZIYElhMgMCSwhRGZIYAkhMkMCSwiRGRJYQojMkMASQmSGBJYQIjMksIQQmSGBJYTIDAksIURmSGAJITLj/wcpq/v2GehmhAAAACV0RVh0ZGF0ZTpjcmVhdGUAMjAxMy0wNC0yOVQwMzoyNTozOSswMDowMLu2PQ8AAAAldEVYdGRhdGU6bW9kaWZ5ADIwMTMtMDQtMjlUMDM6MjU6MzkrMDA6MDDK64WzAAAAAElFTkSuQmCC"
},
"components": [
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Комплекта.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json"
},
"id": "c21646cf-ee08-11e6-8af5-581e00000023",
"accountId": "badae4a0-ee05-11e6-8af5-581e00000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/bb430a4e-ee05-11e6-8af5-581e0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/bade121f-ee05-11e6-8af5-581e00000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-02-08 17:13:26",
"name": "Комплект с картинкой",
"code": "00003",
"externalCode": "iOzqxcTCiAK1-6-eAjVR12",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"image": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/bd159783-95ee-11e6-8a84-bae500000001",
"mediaType": "application/octet-stream"
},
"updated": "2017-01-11 14:54:10",
"title": "birdimage.png",
"filename": "birdimage.png",
"size": 14052,
"miniature": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/bd159783-95ee-11e6-8a84-bae500000001?miniature=true",
"mediaType": "image/png"
},
"tiny": {
"href": "https://online.moysklad.ru/app/download/bd14f0b6-95ee-11e6-8a84-bae500000000.png",
"mediaType": "image/png"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 20,
"currency": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/currency/bb724075-ee05-11e6-8af5-581e00000058",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean13": "2000000000039"
}
],
"components": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components",
"type": "bundlecomponent",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000c",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000c",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000d",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000d",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b9",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}
}
Массовое создание и обновление Комплектов
Массовое создание и обновление Комплектов. В теле запроса нужно передать массив, содержащий JSON представления Комплектов, которые вы хотите создать или обновить. Обновляемые Комплекты должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Комплектов
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/bundle"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "Комплект с товаром и еще одним товаром",
"code": "00003",
"externalCode": "iOzqxcTCiAK1-6-eAjVR12",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 20,
"currency": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/currency/bb724075-ee05-11e6-8af5-581e00000058",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"components": [
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b9",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json"
},
"name": "Новое наименование",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
]
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Комплектов.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json"
},
"id": "c21646cf-ee08-11e6-8af5-581e00000023",
"accountId": "badae4a0-ee05-11e6-8af5-581e00000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/bb430a4e-ee05-11e6-8af5-581e0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/bade121f-ee05-11e6-8af5-581e00000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-02-08 17:13:26",
"name": "Комплект с товаром и еще одним товаром",
"code": "00003",
"externalCode": "iOzqxcTCiAK1-6-eAjVR12",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 20,
"currency": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/currency/bb724075-ee05-11e6-8af5-581e00000058",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"components": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components",
"type": "bundlecomponent",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000c",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000c",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000d",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000d",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b9",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json"
},
"id": "c21646cf-ee08-11e6-8af5-581e00000023",
"accountId": "badae4a0-ee05-11e6-8af5-581e00000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/bb430a4e-ee05-11e6-8af5-581e0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/bade121f-ee05-11e6-8af5-581e00000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-02-08 17:13:26",
"name": "Новое наименование",
"code": "00003",
"externalCode": "iOzqxcTCiAK1-6-eAjVR12",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 20,
"currency": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/currency/bb724075-ee05-11e6-8af5-581e00000058",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"components": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components",
"type": "bundlecomponent",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000c",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000c",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000d",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000d",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b9",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}
}
]
Метаданные Комплектов
Метаданные Комплектов
Запрос на получение метаданных Комплектов. Результат - объект JSON, включающий в себя: + meta - Метаданные + attributes - коллекция всех существующих доп. полей Комплектов в формате Метаданных
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Получить метаданные комплектов
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Комплектов.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata/attributes/5a374c72-ee21-11e6-8af5-581e00000003",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5a374c72-ee21-11e6-8af5-581e00000003",
"name": "доп строка",
"type": "string",
"required": false
}
]
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata/attributes/5a374c72-ee21-11e6-8af5-581e00000003",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5a374c72-ee21-11e6-8af5-581e00000003",
"name": "доп строка",
"type": "string",
"required": false
}
Комплект
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Комплекта. |
Получить Комплект
Запрос на получение комплекта с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление комплекта.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json"
},
"id": "c21646cf-ee08-11e6-8af5-581e00000023",
"accountId": "badae4a0-ee05-11e6-8af5-581e00000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/bb430a4e-ee05-11e6-8af5-581e0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/bade121f-ee05-11e6-8af5-581e00000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-02-08 17:13:26",
"name": "Комплект с товаром и услугой",
"code": "00003",
"externalCode": "iOzqxcTCiAK1-6-eAjVR12",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 0,
"currency": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/currency/bb724075-ee05-11e6-8af5-581e00000058",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean13": "2000000000039"
}
],
"components": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components",
"type": "bundlecomponent",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Изменить Комплект
Запрос на обновление существующего Комплекта. Типы цен в ценах продаж, дополнительные поля и компоненты обновляются как элементы вложенных коллекций: + Если в текущем объекте у какого-то из доп. полей / типов цен / компонентов нет значения, а в переданной коллекции оно есть - значение записывается в доп. поле / тип цены / компонент. + Если же у данного атрибута значение уже присутствует - оно перезаписывается на переданное. + Если у данного атрибута в составе объекта значение присутствует, однако оно отсутствует в передаваемой в теле запроса коллекции (не передаётся совсем), то значение атрибута объекта не изменяется.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Комплекта. |
Пример запроса на обновление Комплекта
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Новое наименование",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Комплекта.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/metadata",
"type": "bundle",
"mediaType": "application/json"
},
"id": "c21646cf-ee08-11e6-8af5-581e00000023",
"accountId": "badae4a0-ee05-11e6-8af5-581e00000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/bb430a4e-ee05-11e6-8af5-581e0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/bade121f-ee05-11e6-8af5-581e00000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-02-08 17:13:26",
"name": "Новое наименование",
"code": "00003",
"externalCode": "iOzqxcTCiAK1-6-eAjVR12",
"archived": false,
"pathName": "",
"uom": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"salePrices": [
{
"value": 20,
"currency": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/currency/bb724075-ee05-11e6-8af5-581e00000058",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
],
"weight": 0,
"volume": 0,
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"components": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components",
"type": "bundlecomponent",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000c",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000c",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000d",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000d",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b9",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}
}
Удалить Комплект
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Комплекта. |
Запрос на удаление Комплекта с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Комплекта.
Компоненты Комплекта
Отдельный ресурс для управления компонентами Комплекта.
Получить компоненты Комплекта
Запрос на получение списка всех компонентов данного Комплекта. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой компоненты Комплекта.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Комплекта. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить компоненты Комплекса
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/7944ef04-f831-11e5-7a69-971500188b19/components"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка компонентов отдельного Комплекта.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components",
"type": "bundlecomponent",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/c21661f2-ee08-11e6-8af5-581e00000026",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "c21661f2-ee08-11e6-8af5-581e00000026",
"accountId": "badae4a0-ee05-11e6-8af5-581e00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/service/b3d8d132-ee08-11e6-8af5-581e00000013",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/c21668eb-ee08-11e6-8af5-581e00000027",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "c21668eb-ee08-11e6-8af5-581e00000027",
"accountId": "badae4a0-ee05-11e6-8af5-581e00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/b01e8dfd-ee08-11e6-8af5-581e00000005",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}
Добавить компонент Комплекта
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Комплекта. |
Запрос на добавление компонента Комплекта.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/7944ef04-f831-11e5-7a69-971500188b19/components"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление добавленного компонента.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000c",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000c",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
Компонент Комплекта
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Комплекта. |
| id | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id компонента Комплекта. |
Получить компонент
Запрос на получение отдельного компонента Комплекта с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/7944ef04-f831-11e5-7a69-971500188b19/components/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного компонента Комплекта.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000c",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000c",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
Обновить компонент
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Комплекта. |
| id | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id компонента Комплекта. |
Запрос на обновление отдельного компонента Комплекта с указанным id.
Пример запроса на обновление компонента Комплекта
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/7944ef04-f831-11e5-7a69-971500188b19/components/34f6344f-015e-11e6-9464-e4de0000006c
"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 50
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного компонента Комплекта.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/bundle/c21646cf-ee08-11e6-8af5-581e00000023/components/9404273f-eeb6-11e6-5bed-427b0000000c",
"type": "bundlecomponent",
"mediaType": "application/json"
},
"id": "9404273f-eeb6-11e6-5bed-427b0000000c",
"accountId": "903083d9-d973-11e6-5bed-427b00000001",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/010afdea-ea40-11e6-5bed-427b000000b8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 50
}
Удалить компонент
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Комплекта. |
| id | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id компонента Комплекта. |
Запрос на удаление отдельного компонента Комплекта с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/bundle/7944ef04-f831-11e5-7a69-971500188b19/components/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление компонента Комплекта.
Группа товаров
Группы товаров
Средствами JSON API можно создавать и обновлять сведения о Группах товаров, запрашивать списки Групп товаров и сведения по отдельным Группам товаров. Кодом сущности для Группы товаров в составе JSON API является ключевое слово productFolder.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке.
Поиск среди объектов групп товаров на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию Группы товаров (name) + по коду Группы товаров (code)
Атрибуты сущности
- meta - Метаданные о Группе товаров
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных)
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- updated - Момент последнего обновления сущности
Только для чтения - name - Наименование Группы товаров
Необходимое - description - Описание Группы товаров
- code - Код Группы товаров
- externalCode - Внешний код Группы товаров
- archived - Добавлена ли Группа товаров в архив
Только для чтения - pathName - Наименование Группы товаров, в которую входит данная Группа товаров
Только для чтения - vat - НДС %
- effectiveVat - Реальный НДС %
Только для чтения - productFolder - Ссылка на Группу товаров данной Группы товаров в формате Метаданных
Получить список групп товаров
Запрос всех Групп товаров на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Группы товаров. Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить список групп товаров
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/productfolder"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Групп товаров.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productFolder",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productFolder/metadata",
"type": "productfolder",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/3ea73e1a-2cad-11e6-8a84-bae50000001d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"id": "3ea73e1a-2cad-11e6-8a84-bae50000001d",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 15:42:07",
"name": "Овощи",
"code": "13321Fruits1",
"externalCode": "mRQao-5IgY3soIY1EaI083",
"archived": false,
"pathName": ""
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/275961ab-2cad-11e6-8a84-bae50000001a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"id": "275961ab-2cad-11e6-8a84-bae50000001a",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"updated": "2016-06-07 15:41:28",
"name": "Фрукты",
"code": "13321Fruits",
"externalCode": "extFruits",
"archived": false,
"pathName": "",
"vat": 3,
"effectiveVat": 3
}
]
}
Создать новую группу товаров
Запрос на создание новой Группы товаров. Обязательные для создания Группы товаров поля: + name - Наименование Группы товаров
Пример создания новой Группы товаров с телом запроса, содержащим только поле name.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/productfolder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Овощи"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Группы товаров.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/3ea73e1a-2cad-11e6-8a84-bae50000001d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"id": "3ea73e1a-2cad-11e6-8a84-bae50000001d",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 15:42:07",
"name": "Овощи",
"code": "13321Fruits1",
"externalCode": "mRQao-5IgY3soIY1EaI083",
"archived": false,
"pathName": ""
}
Пример создания новой Группы товаров с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/productfolder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Фрукты",
"code": "13321Fruits",
"externalCode": "extFruits",
"vat": 3,
"effectiveVat": 3
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Группы товаров.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/275961ab-2cad-11e6-8a84-bae50000001a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"id": "275961ab-2cad-11e6-8a84-bae50000001a",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 15:41:28",
"name": "Фрукты",
"code": "13321Fruits",
"externalCode": "extFruits",
"archived": false,
"pathName": "",
"vat": 3,
"effectiveVat": 3
}
Массовое создание и обновление Групп товаров
Массовое создание и обновление Групп товаров. В теле запроса нужно передать массив, содержащий JSON представления Групп товаров, которые вы хотите создать или обновить. Обновляемые Группы товаров должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Групп товаров
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/productfolder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "Овощи"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/3ea73e1a-2cad-11e6-8a84-bae50000001d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"name": "Группа Овощи",
"code": "vegetableFolderCode",
"externalCode": "extVegCode",
"vat": 5,
"effectiveVat": 5
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Групп товаров.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/3ea73e1a-2cad-11e6-8a84-bae50000001d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"id": "3ea73e1a-2cad-11e6-8a84-bae50000001d",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 15:42:07",
"name": "Овощи",
"code": "13321Fruits1",
"externalCode": "mRQao-5IgY3soIY1EaI083",
"archived": false,
"pathName": ""
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/3ea73e1a-2cad-11e6-8a84-bae50000001d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"id": "3ea73e1a-2cad-11e6-8a84-bae50000001d",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 15:45:28",
"name": "Группа Овощи",
"code": "vegetableFolderCode",
"externalCode": "extVegCode",
"archived": false,
"pathName": "",
"vat": 5,
"effectiveVat": 5
}
]
Удалить Группу товаров
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Группы товаров. |
Запрос на удаление Группы товаров с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/productfolder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Группы товаров.
Метаданные Групп товаров
Метаданные Групп товаров
Запрос на получение метаданных Групп товаров. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Групп товаров + attributes - Массив объектов доп. полей Групп товаров в формате Метаданных
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Получить метаданные Групп товаров
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Групп товаров.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
]
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
Группа товаров
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Группы товаров. |
Получить Группу товаров
Запрос на получение отдельной группы товаров с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/productfolder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Группы товаров.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/3ea73e1a-2cad-11e6-8a84-bae50000001d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"id": "3ea73e1a-2cad-11e6-8a84-bae50000001d",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 15:42:07",
"name": "Овощи",
"code": "13321Fruits1",
"externalCode": "mRQao-5IgY3soIY1EaI083",
"archived": false,
"pathName": ""
}
Изменить Группу товаров
Запрос на обновление Группы товаров с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Группы товаров, кроме тех, что
помечены Только для чтения в описании атрибутов Группы товаров.
Для обновления поля pathName нужно обновить ссылку на родительскую Группу товаров, т.е. обновить поле
productFolder
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Группы товаров. |
Request Пример (application/json) Пример запроса на обновление конкретной Группы товаров.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/productfolder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Группа Овощи",
"code": "vegetableFolderCode",
"externalCode": "extVegCode",
"vat": 5,
"effectiveVat": 5
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Группы товаров.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/3ea73e1a-2cad-11e6-8a84-bae50000001d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"id": "3ea73e1a-2cad-11e6-8a84-bae50000001d",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 15:45:28",
"name": "Группа Овощи",
"code": "vegetableFolderCode",
"externalCode": "extVegCode",
"archived": false,
"pathName": "",
"vat": 5,
"effectiveVat": 5
}
Модификация
Модификации
Средствами JSON API можно создавать и обновлять сведения о Модификациях товаров, запрашивать списки Модификаций товаров и сведения по отдельным Модификациям. Кодом сущности для Модификации в составе JSON API является ключевое слово variant. Больше о Модификациях товаров и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по
этой ссылке,
а также больше о работе с товарами здесь.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов модификаций на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию товара с Модификацией name
Атрибуты Сущности
- meta - Метаданные объекта
- id - ID услуги в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - Момент последнего обновления сущности
Только для чтения - name - Наименование товара с Модификацией
- code - Код Модификации
- externalCode - Внешний код Модификации
- archived - Добавлен ли товар в архив
- characteristics - Характеристики Модификации
Необходимое - minPrice - Минимальная цена
- buyPrice - Закупочная цена
- salePrices - Цены продажи
- barcodes - Массив штрихкодов модификации
- product - Метаданные, представляющие с собой ссылку на товар, к которому привязана Модификация.
Необходимое - things - Серийные номера
Только для чтения
Атрибуты доступные для сортировки
- code - Код Модификации
- externalCode - Внешний код Модификации
- archived - Добавлен ли товар в архив
Атрибуты вложенных сущностей
Штрих коды:
При создании штрихкода требуется описать объект с полем, являющимся форматом представления штрихкода в нижнем регистре, со строковым значением самого штрихкода. Наименование полей отдельного объекта, представляющего штрихкод:
- ean13 - штрихкод в формате EAN13, если требуется создать штрихкод в формате EAN13
- ean8 - штрихкод в формате EAN8, если требуется создать штрихкод в формате EAN8
- code128 - штрихкод в формате Code128, если требуется создать штрихкод в формате Code128
Метаданные Модификаций
Метаданные Модификаций содержат информацию о характеристиках Модификаций, а также о типах цен. Характеристики Модификации - внутренняя коллекция characteristics. Представлена в виде массива объектов с полями: + meta - метаданные характеристики + id - id соответствующей характеристики. + name - наименование характеристики. + value - значение характеристики.
Посмотреть все созданные в основном интерфейсе характеристики Модификаций, а также все типы цен можно с помощью запроса на получение метаданных Модификаций. Ответ - объект, со следующей структурой: + meta - Метаданные + characteristics - коллекция всех созданных характеристик Модификаций.
Структуры отдельных объектов коллекций:
characteristics
- meta - Метаданные характеристики
- id - ID характеристики
- name - Наименование характеристики
- type - Тип значения характеристики
- required - Флажок о том, является ли характеристика обязательной
Цены продажи
Если у модификации не заданы отдельные цены продажи, в ответе будут выведены соответствующие цены продажи товара. + value - Значение цены + currency - Ссылка на валюту в формате Метаданных + priceType - Тип цены
Минимальная цена
- value - Значение цены
- currency - Ссылка на валюту в формате Метаданных
Получить список Модификаций
Запрос на получение списка всех Модификаций на данной учётной записи. Результат успешного запроса - JSON представление списка Модификаций с перечисленными полями: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Модификации.
Возможна фильтрация списка Модификаций по id товара - параметр productid. Подробнее про данный параметр можно посмотреть в разделе Фильтрация выборки с помощью параметра filter
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить список модификаций
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/variant"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Модификаций.
{
"context": {
"employee": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66cc36dc-f7d2-11e5-8a84-bae500000074/671402e4-f7d2-11e5-8a84-bae50000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"id": "671402e4-f7d2-11e5-8a84-bae50000007c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-01 09:24:34",
"name": "ТоварМногоМодификаций (1, 100, 10)",
"code": "00005",
"externalCode": "rAhHA0T1glL2xY3d1aHFT2",
"archived": false,
"characteristics": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/7a6078e4-3c64-11e6-8a84-bae500000003",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "7a6078e4-3c64-11e6-8a84-bae500000003",
"name": "Цвет",
"value": "красны"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/7a6078e4-3c64-11e6-8a84-bae500000003",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "7a6078e4-3c64-11e6-8a84-bae500000003",
"name": "Свежесть",
"value": "Свежий"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/7a6078e4-3c64-11e6-8a84-bae500000003",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "7a6078e4-3c64-11e6-8a84-bae500000003",
"name": "Вкус",
"value": "Вкусный"
}
],
"buyPrice": {
"value": 0
},
"salePrices": [
{
"value": 0,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 0,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
},
{
"value": 0,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"name": "Цена для конкурентов",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f434444"
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
Создать Модификацию
Создать новую Модификацию. Для создания новой Модификации необходимы поля product, characteristics. Поле characteristics указывается как массив объектов со следующей структурой: + id - uuid характеристики + value - значение характеристики Если поле id не указано у какого-либо объекта характеристики, производится поиск соответствующей этому объекту характеристики по полю name. Если же не указаны ни id ни name произойдёт ошибка.
Пример запроса на создание новой Модификации, привязанной к существующему товару.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/variant"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "(оверспелый, жёлтый)",
"characteristics": [
{
"id": "627610e3-2cb1-11e6-8a84-bae500000054",
"value": "оверспелый"
},
{
"id": "627617d8-2cb1-11e6-8a84-bae500000055",
"value": "черный"
}
],
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 20
},
"salePrices": [
{
"value": 900,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 102,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 200,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/86951fbe-2cb0-11e6-8a84-bae500000043",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Модификации.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/14553caa-2cb2-11e6-8a84-bae500000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"id": "14553caa-2cb2-11e6-8a84-bae500000026",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"updated": "2016-06-07 16:16:43",
"name": "Банан (оверспелый, черный)",
"code": "00011",
"externalCode": "tQcC7LdEjTZMh85Em6FTW1",
"archived": false,
"characteristics": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627610e3-2cb1-11e6-8a84-bae500000054",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "627610e3-2cb1-11e6-8a84-bae500000054",
"name": "Спелость",
"value": "оверспелый"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627617d8-2cb1-11e6-8a84-bae500000055",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "627617d8-2cb1-11e6-8a84-bae500000055",
"name": "Цвет",
"value": "черный"
}
],
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 20
},
"salePrices": [
{
"value": 900,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 102,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
},
{
"value": 200,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"name": "Цена для конкурентов",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f434444"
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/86951fbe-2cb0-11e6-8a84-bae500000043",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Массовое создание и обновление Модификаций
Массовое создание и обновление Модификаций. В теле запроса нужно передать массив, содержащий JSON представления Модификаций, которые вы хотите создать или обновить. Обновляемые Модификации должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Модификаций
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/variant"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "(оверспелый, жёлтый)",
"characteristics": [
{
"id": "627610e3-2cb1-11e6-8a84-bae500000054",
"value": "оверспелый"
},
{
"id": "627617d8-2cb1-11e6-8a84-bae500000055",
"value": "черный"
}
],
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 20
},
"salePrices": [
{
"value": 900,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 102,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 200,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/86951fbe-2cb0-11e6-8a84-bae500000043",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/b2347044-181d-11e6-9464-e4de00000015",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"characteristics": [
{
"id": "07e9aa56-137b-11e6-9464-e4de000000e7",
"value": "Средний"
},
{
"id": "07e9b661-137b-11e6-9464-e4de000000e8",
"value": "Оранжевый"
},
{
"id": "60907bc8-137b-11e6-9464-e4de00000155",
"value": "Свежий"
}
],
"code": "orangeCode",
"externalCode": "orange303",
"buyPrice": {
"value": 700
},
"salePrices": [
{
"value": 1100,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 702,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 200,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Модификаций.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/14553caa-2cb2-11e6-8a84-bae500000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"id": "14553caa-2cb2-11e6-8a84-bae500000026",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"updated": "2016-06-07 16:16:43",
"name": "Банан (оверспелый, черный)",
"code": "00011",
"externalCode": "tQcC7LdEjTZMh85Em6FTW1",
"archived": false,
"characteristics": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627610e3-2cb1-11e6-8a84-bae500000054",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "627610e3-2cb1-11e6-8a84-bae500000054",
"name": "Спелость",
"value": "оверспелый"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627617d8-2cb1-11e6-8a84-bae500000055",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "627617d8-2cb1-11e6-8a84-bae500000055",
"name": "Цвет",
"value": "черный"
}
],
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 20
},
"salePrices": [
{
"value": 900,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 102,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
},
{
"value": 200,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"name": "Цена для конкурентов",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f434444"
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/86951fbe-2cb0-11e6-8a84-bae500000043",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/b2347044-181d-11e6-9464-e4de00000015",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"id": "b2347044-181d-11e6-9464-e4de00000015",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"updated": "2016-05-12 11:56:15",
"name": "Апельсины (Средний, Оранжевый, Свежий)",
"code": "orangeCode",
"externalCode": "orange303",
"archived": false,
"characteristics": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627610e3-2cb1-11e6-8a84-bae500000054",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "07e9aa56-137b-11e6-9464-e4de000000e7",
"name": "Размер",
"value": "Средний"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627610e3-2cb1-11e6-8a84-bae500000054",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "07e9b661-137b-11e6-9464-e4de000000e8",
"name": "Цвет",
"value": "Оранжевый"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627610e3-2cb1-11e6-8a84-bae500000054",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "60907bc8-137b-11e6-9464-e4de00000155",
"name": "Свежесть",
"value": "Свежий"
}
],
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 700
},
"salePrices": [
{
"value": 1100,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 702,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
},
{
"value": 200,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"name": "Цена для конкурентов",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f434444"
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/07ed3a66-137b-11e6-9464-e4de000000eb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
Удалить Модификацию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Модификации. |
Запрос на удаление Модификации с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/variant/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Модификации.
Метаданные Модификаций
Метаданные Модификаций
Запрос на получение метаданных Модификаций. Результат - объект JSON, включающий в себя: + meta - Метаданные + characteristics - коллекция всех созданных характеристик Модификаций.
Получить метаданные модификаций
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных модификации.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"mediaType": "application/json"
},
"characteristics": [
{
"id": "fd68704f-f67d-11e5-8a84-bae50000006b",
"name": "feature",
"type": "string",
"required": false
},
{
"id": "66bcdde0-f7d2-11e5-8a84-bae500000072",
"name": "Вес",
"type": "string",
"required": false
},
{
"id": "66be57d2-f7d2-11e5-8a84-bae500000073",
"name": "Размер",
"type": "string",
"required": false
},
{
"id": "daec003b-fa34-11e5-9464-e4de0000006c",
"name": "Мода",
"type": "string",
"required": false
}
]
}
Модификация
Работа с Модификацией с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id серии. |
| id | 7944ef04-f831-11e5-7a69-971500188b19 (required, string) - id серии |
Получить Модификацию
Запрос на получение представления Модификации с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/variant/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Модификации.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"id": "7a81082f-3c64-11e6-8a84-bae50000000e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-27 15:41:33",
"name": "фацфацфвф (обхец)",
"code": "00003",
"externalCode": "YQ3kNHfDgtHOVhf20Md7Q0",
"archived": false,
"characteristics": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/7a6078e4-3c64-11e6-8a84-bae500000003",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "7a6078e4-3c64-11e6-8a84-bae500000003",
"name": "Цвет",
"value": "обхец"
}
],
"salePrices": [
{
"value": 0,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 0,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
},
{
"value": 0,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"name": "Цена для конкурентов",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f434444"
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Изменить Модификацию
Запрос на обновление Модификации с указанным id. Типы цен в ценах продаж обновляются как элементы вложенных коллекций: + Если в текущем объекте у какого-то из типов цен нет значения, а в переданной коллекции оно есть - значение записывается в тип цены. + Если же у данного атрибута значение уже присутствует - оно перезаписывается на переданное. + Если у данного атрибута в составе объекта значение присутствует, однако оно отсутствует в передаваемой в теле запроса коллекции (не передаётся совсем), то значение атрибута объекта не изменяется.
При обновлении характеристик Модификации поле characteristics указывается как массив объектов со следующей структурой: + id - uuid характеристики + name - наименование характеристики + value - значение характеристики Если поле id не указано у какого-либо объекта характеристики, производится поиск соответствующей этому объекту характеристики по полю name. Если же не указаны ни id ни name произойдёт ошибка. При обновлении, поле characteristics в теле запроса обрабатывается как "все характеристики модификации", т.е. полностью заменяет предыдущий массив характеристик. Если какая то из характеристик, имевшая значение в обновляемом объекте не указана в запросе на обновление, после запроса её значение будет аннулированно.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id серии. |
Пример запроса на обновление Модификации.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/variant/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"characteristics": [
{
"id": "07e9aa56-137b-11e6-9464-e4de000000e7",
"value": "Средний"
},
{
"id": "07e9b661-137b-11e6-9464-e4de000000e8",
"value": "Оранжевый"
},
{
"id": "60907bc8-137b-11e6-9464-e4de00000155",
"value": "Свежий"
}
],
"code": "orangeCode",
"externalCode": "orange303",
"buyPrice": {
"value": 700
},
"salePrices": [
{
"value": 1100,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 702,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
{
"value": 200,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
}
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление Модификации.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/b2347044-181d-11e6-9464-e4de00000015",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"id": "b2347044-181d-11e6-9464-e4de00000015",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"updated": "2016-05-12 11:56:15",
"name": "Апельсины (Средний, Оранжевый, Свежий)",
"code": "orangeCode",
"externalCode": "orange303",
"archived": false,
"characteristics": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627610e3-2cb1-11e6-8a84-bae500000054",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "07e9aa56-137b-11e6-9464-e4de000000e7",
"name": "Размер",
"value": "Средний"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627610e3-2cb1-11e6-8a84-bae500000054",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "07e9b661-137b-11e6-9464-e4de000000e8",
"name": "Цвет",
"value": "Оранжевый"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata/characteristics/627610e3-2cb1-11e6-8a84-bae500000054",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "60907bc8-137b-11e6-9464-e4de00000155",
"name": "Свежесть",
"value": "Свежий"
}
],
"minPrice": {
"value": 500,
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"buyPrice": {
"value": 700
},
"salePrices": [
{
"value": 1100,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
},
{
"value": 702,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
}
},
{
"value": 200,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"name": "Цена для конкурентов",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f434444"
}
}
],
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/07ed3a66-137b-11e6-9464-e4de000000eb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Серия
Серии
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов Серии на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию Серии name + по описанию Серии description
Атрибуты сущности
- meta - Метаданные объекта
- id - ID услуги в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - Момент последнего обновления сущности
Только для чтения` - name - Наименование Серии. "Собирается" и отображается как "Наименование товара / Метка Серии"
Только для чтения - description - Описание Серии
- code - Код Серии
- externalCode - Внешний код Серии
- label - Метка Серии.
Необходимое - barcodes - Штрихкоды серии
- image - Изображение товара, к которому относится данная серия
- assortment - Метаданные, представляющие с собой ссылку на товар или модификацию
Необходимое
Атрибуты вложенных сущностей
Метаданные Серий
Посмотреть все созданные в основном интерфейсе характеристики Серий можно с помощью запроса на получение метаданных Серий. Ответ - объект, со следующей структурой: + meta - Метаданные + attributes - коллекция всех существующих доп. полей Серий в формате Метаданных
Получить список Серий
Запрос на получения списка всех пользовательских Серий на данной учётной записи. Серии по умолчанию выведены не будут. Результат успешного запроса - JSON представление списка Серий с перечисленными полями: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Серии.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить список Серий
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/consignment"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка пользовательских Серий.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/consignment",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata",
"type": "consignment",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/c66f4b17-36e7-11e7-8a7f-40d000000113",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata",
"type": "consignment",
"mediaType": "application/json"
},
"id": "c66f4b17-36e7-11e7-8a7f-40d000000113",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"updated": "2017-05-12 10:51:15",
"name": "product / consignment",
"code": "1012",
"externalCode": "g9BOLNRZglk9NMOHxcrVV0",
"label": "consignment",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"image": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/10385ef8-0639-4fbc-8bb4-6898e5e8b897",
"mediaType": "application/octet-stream"
},
"title": "pear",
"filename": "pear.jpg",
"size": 46197,
"updated": "2018-06-04 12:59:01",
"miniature": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/10385ef8-0639-4fbc-8bb4-6898e5e8b897?miniature=true",
"mediaType": "image/png"
},
"tiny": {
"href": "https://online.moysklad.ru/app/download/6f38cce9-dbc5-407c-bcd4-f433a1b8c960/t.png",
"mediaType": "image/png"
}
},
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/35427052-36e7-11e7-8a7f-40d0000000d1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
Создать серию
Запрос на создание новой серии. Для успешного создания серии, обязательно должны быть переданы поля label и assortment. + Request Пример (application/json)
Пример создания новой серии.
curl -X POST
" \https://online.moysklad.ru/api/remap/1.2/entity/consignment"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '
"label": "Метка",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной серии.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/17a32a0a-5310-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata",
"type": "consignment",
"mediaType": "application/json"
},
"id": "17a32a0a-5310-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-07-26 12:05:25",
"name": "фацфацфвф (цфвцф) / Метка",
"externalCode": "NptSJ1REgVkhqCV0RlyfV0",
"label": "Метка",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
Удалить серию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Серии. |
Запрос на удаление Серии с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/consignment/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Серии.
Массовое создание и обновление Серий
Массовое создание и обновление Серий. В теле запроса нужно передать массив, содержащий JSON представления Серий, которые вы хотите создать или обновить. Обновляемые Серии должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Серий
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/consignment"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"label": "Метка",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/17a32a0a-5310-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata",
"type": "consignment",
"mediaType": "application/json"
},
"code": "ke21k421c1o42n4signment12",
"externalCode": "fbajkwbfu1249SACSKW241LKSFA2sa1",
"description": "Серии товаров с таким названием лучше отслеживать",
"label": "Странный товар",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Серий.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/17a32a0a-5310-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata",
"type": "consignment",
"mediaType": "application/json"
},
"id": "17a32a0a-5310-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-07-26 12:05:25",
"name": "фацфацфвф (цфвцф) / Метка",
"externalCode": "NptSJ1REgVkhqCV0RlyfV0",
"label": "Метка",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/17a32a0a-5310-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata",
"type": "consignment",
"mediaType": "application/json"
},
"id": "17a32a0a-5310-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-07-26 12:05:25",
"name": "фацфацфвф (обхец) / Странный товар",
"description": "Серии товаров с таким названием лучше отслеживать",
"code": "ke21k421c1o42n4signment12",
"externalCode": "fbajkwbfu1249SACSKW241LKSFA2sa1",
"label": "Странный товар",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
Метаданные Серий
Метаданные Серий
Запрос на получение метаданных Серий. Результат - объект JSON, включающий в себя: + meta - Метаданные + attributes - коллекция всех существующих доп. полей Серий в формате Метаданных
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Получить метданные Серии
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных серии.
{
"meta": {
"href": "hhttps://online.moysklad.ru/api/remap/1.2/entity/consignment",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "hhttps://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata/attributes/83dc3e6c-3bbf-11e7-8a7f-40d000000001",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "83dc3e6c-3bbf-11e7-8a7f-40d000000001",
"name": "string",
"type": "string",
"required": false
},
{
"meta": {
"href": "hhttps://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata/attributes/958b275e-3bbf-11e7-8a7f-40d000000004",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "958b275e-3bbf-11e7-8a7f-40d000000004",
"name": "number",
"type": "long",
"required": false
}
]
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 958b275e-3bbf-11e7-8a7f-40d000000004 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata/attributes/958b275e-3bbf-11e7-8a7f-40d000000004"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "hhttps://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata/attributes/958b275e-3bbf-11e7-8a7f-40d000000004",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "958b275e-3bbf-11e7-8a7f-40d000000004",
"name": "number",
"type": "long",
"required": false
}
Серия
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Серии. |
Получить серию
Запрос на получение Серии с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/consignment/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление пользовательской Серии.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/c66f4b17-36e7-11e7-8a7f-40d000000113",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata",
"type": "consignment",
"mediaType": "application/json"
},
"id": "c66f4b17-36e7-11e7-8a7f-40d000000113",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"updated": "2017-05-12 10:51:15",
"name": "product / consignment",
"code": "1012",
"externalCode": "g9BOLNRZglk9NMOHxcrVV0",
"label": "consignment",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"image": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/10385ef8-0639-4fbc-8bb4-6898e5e8b897",
"mediaType": "application/octet-stream"
},
"title": "pear",
"filename": "pear.jpg",
"size": 46197,
"updated": "2018-06-04 12:59:01",
"miniature": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/10385ef8-0639-4fbc-8bb4-6898e5e8b897?miniature=true",
"mediaType": "image/png"
},
"tiny": {
"href": "https://online.moysklad.ru/app/download/6f38cce9-dbc5-407c-bcd4-f433a1b8c960/t.png",
"mediaType": "image/png"
}
},
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/35427052-36e7-11e7-8a7f-40d0000000d1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Изменить серию
Параметры
|Параметр |Описание |
|---|---|
|id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Серии.|
Запрос на обновление серии. Обновить можно только те поля, что не помечены Только для чтения
Пример запроса на обновление серии.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/consignment/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"code": "ke21k421c1o42n4signment12",
"externalCode": "fbajkwbfu1249SACSKW241LKSFA2sa1",
"description": "Серии товаров с таким названием лучше отслеживать",
"label": "Странный товар",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой серии.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/17a32a0a-5310-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/consignment/metadata",
"type": "consignment",
"mediaType": "application/json"
},
"id": "17a32a0a-5310-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-07-26 12:05:25",
"name": "фацфацфвф (обхец) / Странный товар",
"description": "Серии товаров с таким названием лучше отслеживать",
"code": "ke21k421c1o42n4signment12",
"externalCode": "fbajkwbfu1249SACSKW241LKSFA2sa1",
"label": "Странный товар",
"barcodes": [
{
"ean8": "20000000"
},
{
"ean13": "2000000000000"
},
{
"code128": "code128 barcode"
}
],
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
Договор
Договоры
Средствами JSON API можно создавать и обновлять сведения о Договорах, запрашивать списки Договоров и сведения по отдельным Договорам. Кодом сущности для Договора в составе JSON API является ключевое слово contract. Больше о Договорах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов Договора на соответствие поисковой строке будет осуществлён по следующим полям: + по номеру Договора name + по комментарию к Договору description
Атрибуты сущности
- meta - Метаданные о Заказе Покупателя
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- updated - Момент последнего обновления сущности
Только для чтения - name - номер Договора
- description - Комментарий к Договору
- code - Код Договора
- externalCode - Внешний код Договора
- archived - Добавлен ли Договор в архив
- moment - Дата Договора,
- sum - Сумма Договора,
- contractType - Тип Договора. Возможные значения:
Договор комиссии,Договор купли-продажи - rewardType - Тип Вознаграждения. Возможные значения:
Процент от суммы продажи,Не рассчитывать - rewardPercent - Вознаграждение в процентах (от 0 до 100).
- ownAgent - Ссылка на ваше юрлицо в формате Метаданных
- agent - Ссылка на Контрагента в формате Метаданные
- state - Статус договора в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- rate - Ссылка на валюту
- attributes - Коллекция доп. полей в формате Метаданных
Таблица полей, их значений и их значений в JSON представлении:
| Имя поля | Возможные Значения | Соответствующее значение в JSON | Значение по умолчанию |
|---|---|---|---|
| contractType | Договор комиссии | Commission | Договор купли-продажи |
| Договор купли-продажи | Sales | ||
| rewardType | Процент от суммы продажи | PercentOfSales | Не рассчитывать |
| Не рассчитывать | None |
О работе с доп. полями Договоров можно прочитать здесь
Получить список Договоров
Запрос на получение списка всех договоров на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Договоры.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить список договоров
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/contract"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Договоров.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/498b8673-0308-11e6-9464-e4de00000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "498b8673-0308-11e6-9464-e4de00000089",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-15 15:48:00",
"name": "14212412",
"externalCode": "WEhvl5LFgyYqa5l6yKRzu3",
"archived": false,
"moment": "2016-04-15 15:47:00",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/78f75b89-fd86-11e5-9464-e4de0000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8c2cab84-0ac0-11e6-9464-e4de00000100",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "8c2cab84-0ac0-11e6-9464-e4de00000100",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 11:34:38",
"name": "Привет, Имя договора",
"description": "Коммент",
"code": "KOOOOD",
"externalCode": "GIpDXPPIh4ytzI9svfcyS3",
"archived": false,
"moment": "2016-04-25 11:33:00",
"sum": 9999999000,
"contractType": "Commission",
"rewardType": "PercentOfSales",
"rewardPercent": 0,
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "8ce3c179-015e-11e6-9464-e4de0000007a",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-13 13:00:28",
"name": "12",
"description": "asdwqeqr",
"code": "cjhjr",
"externalCode": "jTNl4F6WhxgFTcczKRT6i2",
"archived": false,
"moment": "2016-04-13 13:00:00",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}
]
}
Создать новый Договор
Запрос на создание нового Договора. Обязательные для создания Договора поля: + name - Номер Договора + ownAgent - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на Контрагента в формате Метаданные
Пример создания нового Договора, с запросом, Тело которого содержит только обязательные поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/contract"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "666",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Договора.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8df02031-0ac4-11e6-9464-e4de00000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "8df02031-0ac4-11e6-9464-e4de00000008",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 12:03:19",
"name": "666",
"externalCode": "y8j8uYVuhd04K8ZGOuu2a1",
"archived": false,
"moment": "2016-04-25 12:03:19",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}
Пример создания нового Договора с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/contract"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "00000011111",
"description": "Договор с партнёрской организацией ООО Солнышко",
"code": "contractWithPartner",
"externalCode": "extC12fd12a",
"moment": "2016-07-06 12:53:22",
"sum": 200000,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/db141159-2c97-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/2e6aa620-2c98-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Договора.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/3bba8d2a-2cb6-11e6-8a84-bae50000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "3bba8d2a-2cb6-11e6-8a84-bae50000002c",
"accountId": "da7d9bbe-2c97-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-07 16:46:27",
"name": "00000011111",
"description": "Договор с партнёрской организацией ООО Солнышко",
"code": "contractWithPartner",
"externalCode": "extC12fd12a",
"archived": false,
"moment": "2016-07-06 12:53:22",
"sum": 200000,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/db141159-2c97-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/2e6aa620-2c98-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/2e6aa620-2c98-11e6-8a84-bae500000004/accounts/2e6ab6ca-2c98-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}
Пример создания нового Договора, с запросом, Тело которого содержит дополнительные поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/contract"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "666",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/73fa8fb0-0ac5-11e6-9464-e4de0000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"name": "666_02",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contractType": "Sales",
"code": "code333",
"externalCode": "exCode333",
"moment": "2017-02-25 12:03:19",
"description": "Договор с контрагентом ООО Поставщик",
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Договора.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8df02031-0ac4-11e6-9464-e4de00000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "8df02031-0ac4-11e6-9464-e4de00000008",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 12:03:19",
"name": "666",
"externalCode": "y8j8uYVuhd04K8ZGOuu2a1",
"archived": false,
"moment": "2016-04-25 12:03:19",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/73fa8fb0-0ac5-11e6-9464-e4de0000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "73fa8fb0-0ac5-11e6-9464-e4de0000000b",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 12:22:17",
"name": "666_02",
"description": "Договор с контрагентом ООО Поставщик",
"code": "code333",
"externalCode": "exCode333",
"archived": false,
"moment": "2017-02-25 12:03:19",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}
]
Массовое создание и обновление Договоров
Массовое создание и обновление Договоров. В теле запроса нужно передать массив, содержащий JSON представления Договоров, которые вы хотите создать или обновить. Обновляемые Договора должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Договоров
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/contract"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "666",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/73fa8fb0-0ac5-11e6-9464-e4de0000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"name": "666_02",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contractType": "Sales",
"code": "code333",
"externalCode": "exCode333",
"moment": "2017-02-25 12:03:19",
"description": "Договор с контрагентом ООО Поставщик",
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Договоров.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8df02031-0ac4-11e6-9464-e4de00000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "8df02031-0ac4-11e6-9464-e4de00000008",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 12:03:19",
"name": "666",
"externalCode": "y8j8uYVuhd04K8ZGOuu2a1",
"archived": false,
"moment": "2016-04-25 12:03:19",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/73fa8fb0-0ac5-11e6-9464-e4de0000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "73fa8fb0-0ac5-11e6-9464-e4de0000000b",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 12:22:17",
"name": "666_02",
"description": "Договор с контрагентом ООО Поставщик",
"code": "code333",
"externalCode": "exCode333",
"archived": false,
"moment": "2017-02-25 12:03:19",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}
]
Удалить договор
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Договора. |
Запрос на удаление Договора с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/contract/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Договора.
Метаданные Договоров
Метаданные Договоров
Запрос на получение метаданных Договоров. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Договоров + attributes - Массив объектов доп. полей Договоров в формате Метаданных + states - Массив статусов Договоров + createShared - создавать новые Договора с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Получение методанных Договора
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Договоров.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "contract"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "contract"
}
],
"createShared": false
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
Договор
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Договора. |
Получить Договор
Запрос на получение отдельного Договора с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/contract/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Договора.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "8ce3c179-015e-11e6-9464-e4de0000007a",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-13 13:00:28",
"name": "12",
"description": "asdwqeqr",
"code": "cjhjr",
"externalCode": "jTNl4F6WhxgFTcczKRT6i2",
"archived": false,
"moment": "2016-04-13 13:00:00",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "25b6f76c-12d5-11e6-9464-e4de00000068",
"name": "Отметка о заключении",
"type": "boolean",
"value": false
}
]
}
Изменить Договор
Запрос на обновление отдельного Договора с указанным id. При обновлении полей organization и agent нужно также обновить поля organizationAccount и agentAccount соответственно, иначе произойдёт ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Договора. |
Пример запроса на обновление отдельного Договора.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/contract/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "666_02",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contractType": "Sales",
"code": "code333",
"externalCode": "exCode333",
"moment": "2017-02-25 12:03:19",
"description": "Договор с контрагентом ООО Поставщик",
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}'
Response 200 (application/json) Удачный запрос. Результат - JSON представление обновлённого Договора.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/73fa8fb0-0ac5-11e6-9464-e4de0000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "73fa8fb0-0ac5-11e6-9464-e4de0000000b",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 12:22:17",
"name": "666_02",
"description": "Договор с контрагентом ООО Поставщик",
"code": "code333",
"externalCode": "exCode333",
"archived": false,
"moment": "2017-02-25 12:03:19",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/342dc6f5-0bbb-11e6-d219-b9d90000004e/accounts/342e096d-0bbb-11e6-d219-b9d90000004f",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
Пример запроса на обновление отдельного Договора с телом запроса, содержащим доп. поля.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/contract/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "123_456",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contractType": "Sales",
"code": "не код 333",
"externalCode": "exC22ode333",
"moment": "2019-03-15 21:03:19",
"description": "Новый договор",
"attributes": [
{
"id": "25b6f76c-12d5-11e6-9464-e4de00000068",
"value": false
}
]
}'
Response 200 (application/json) Удачный запрос. Результат - JSON представление обновлённого Договора.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/7c0c5b6d-12d5-11e6-9464-e4de0000000c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
},
"id": "7c0c5b6d-12d5-11e6-9464-e4de0000000c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-05 18:27:44",
"name": "123_456",
"description": "Новый Договор",
"code": "не код 333",
"externalCode": "exC22ode333",
"archived": false,
"moment": "2019-03-15 21:03:19",
"sum": 0,
"contractType": "Sales",
"ownAgent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "25b6f76c-12d5-11e6-9464-e4de00000068",
"name": "Отметка о заключении",
"type": "boolean",
"value": false
}
],
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
}
}
Проект
Проекты
Средствами JSON API можно создавать и обновлять сведения о Проектах, запрашивать списки Проектов и сведения по отдельным Проектам. Кодом сущности для Проекта в составе JSON API является ключевое слово project. Больше о Проектах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов проекта на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию Проекта name + по описанию Проекта description
Атрибуты сущности
- meta - Метаданные о Проекте
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- updated - Момент последнего обновления сущности
Только для чтения - name - Наименование Проекта
Необходимое - description - Описание Проекта
- code - Код Проекта
- externalCode - Внешний код Проекта
- archived - Добавлен ли Проект в архив
- attributes - Коллекция доп. полей в формате Метаданных
О работе с доп. полями Проектов можно прочитать здесь
Получить Проекты
Запрос на получение списка всех проектов на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой проекты.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Проекты
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/project"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка проектов.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/51f263f9-0307-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"id": "51f263f9-0307-11e6-9464-e4de0000007c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-15 15:41:05",
"name": "Аггрегатор томатной пасты",
"description": "Проект по сбору и переработке томатной пасты от всех поставщиков",
"code": "1248y12hrd",
"externalCode": "HZV7dGc8iAnf0aNjrvQvN0",
"archived": false,
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ddff1ee8-12c1-11e6-9464-e4de0000007a",
"name": "Приоритет проекта",
"type": "string",
"value": "Высокий"
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/8477d916-0aef-11e6-9464-e4de00000103",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"id": "8477d916-0aef-11e6-9464-e4de00000103",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 17:10:51",
"name": "План",
"description": "Проект отслеживающий выполнение плана продаж",
"code": "124721fsavy",
"externalCode": "lv7MmPK4jvaqq-nA3g3NL2",
"archived": false,
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ddff1ee8-12c1-11e6-9464-e4de0000007a",
"name": "Приоритет проекта",
"type": "string",
"value": "Низкий"
}
]
}
]
}
Создать Проект
Запрос на создание нового проекта. Единственным необходимым полем в теле запроса для создания проекта является name.
Пример запроса на создание нового проекта.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/project"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Проект по вертикальной интеграциии с Поставщиком",
"description": "Интеграция с основным контрагентом",
"code": "006",
"externalCode": "814fhsafiwb124"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного проекта.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/2c013eeb-0af0-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"id": "2c013eeb-0af0-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 17:15:32",
"name": "Проект по вертикальной интеграциии с Поставщиком",
"description": "Интеграция с основным контрагентом",
"code": "006",
"externalCode": "814fhsafiwb124",
"archived": false
}
Пример запроса на создание нового проекта с доп. полями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/project"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Новая система учёта",
"description": "Проект по переходу на новую систему учёта продукции",
"code": "0026",
"externalCode": "213zzz",
"attributes": [
{
"id": "ddff1ee8-12c1-11e6-9464-e4de0000007a",
"value": "Средний"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного проекта.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/169ed74e-12c3-11e6-9464-e4de00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"id": "169ed74e-12c3-11e6-9464-e4de00000000",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-05 16:12:58",
"name": "Новая система учёта",
"description": "Проект по переходу на новую систему учёта продукции",
"code": "0026",
"externalCode": "213zzz",
"archived": false,
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ddff1ee8-12c1-11e6-9464-e4de0000007a",
"name": "Приоритет проекта",
"type": "string",
"value": "Средний"
}
]
}
Массовое создание и обновление Проектов
Массовое создание и обновление Проектов. В теле запроса нужно передать массив, содержащий JSON представления Проектов, которые вы хотите создать или обновить. Обновляемые Проекты должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Проектов
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/project"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "Проект по вертикальной интеграциии с Поставщиком",
"description": "Интеграция с основным контрагентом",
"code": "006",
"externalCode": "814fhsafiwb124"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/76e88dff-3f9b-11e6-8a84-bae50000009b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"description": "Обновление проекта",
"code": "9999",
"externalCode": "dfDGFSG44"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Проектов.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/2c013eeb-0af0-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"id": "2c013eeb-0af0-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 17:15:32",
"name": "Проект по вертикальной интеграциии с Поставщиком",
"description": "Интеграция с основным контрагентом",
"code": "006",
"externalCode": "814fhsafiwb124",
"archived": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/76e88dff-3f9b-11e6-8a84-bae50000009b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"id": "76e88dff-3f9b-11e6-8a84-bae50000009b",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 17:17:21",
"name": "Важный проект",
"description": "Обновление проекта",
"code": "9999",
"externalCode": "dfDGFSG44",
"archived": false
}
]
Удалить Проект
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Проекта. |
Запрос на удаление Проекта с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/project/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Проекта.
Метаданные Проектов
Метаданные Проектов
Запрос на получение метаданных Проектов. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Проектов + attributes - Массив объектов доп. полей Проектов в формате Метаданных + createShared - создавать новые Проекты с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Методанные проектов
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/project/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Проектов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
],
"createShared": true
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/project/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
Проект
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Проекта. |
Получить Проект
Запрос на получение отдельного проекта с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/project/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление проекта.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/51f263f9-0307-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"id": "51f263f9-0307-11e6-9464-e4de0000007c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-15 15:41:05",
"name": "Аггрегатор томатной пасты",
"description": "Проект по сбору и переработке томатной пасты от всех поставщиков",
"code": "1248y12hrd",
"externalCode": "HZV7dGc8iAnf0aNjrvQvN0",
"archived": false,
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ddff1ee8-12c1-11e6-9464-e4de0000007a",
"name": "Приоритет проекта",
"type": "string",
"value": "Средний"
}
]
}
Изменить Проект
Запрос на обновление существующего проекта с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Проекта. |
Пример запроса на обновление существующего проекта.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/project/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Проект по вертикальной интеграциии с Поставщиком",
"description": "Интеграция с ключевым контрагентом",
"code": "006_1",
"externalCode": "cas12rgs"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого проекта.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/2c013eeb-0af0-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"id": "2c013eeb-0af0-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-25 17:17:21",
"name": "Проект по вертикальной интеграциии с Поставщиком",
"description": "Интеграция с ключевым контрагентом",
"code": "006_1",
"externalCode": "cas12rgs",
"archived": false
}
Пример запроса на обновление существующего проекта с доп полями в теле запроса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/project/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Новая система учёта и сбыта",
"description": "Проект по переходу на новую систему учёта и сбыта продукции",
"code": "123",
"externalCode": "fbeuf21dof1f",
"attributes": [
{
"id": "ddff1ee8-12c1-11e6-9464-e4de0000007a",
"value": "Крайне высокий"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого проекта.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/169ed74e-12c3-11e6-9464-e4de00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
},
"id": "169ed74e-12c3-11e6-9464-e4de00000000",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-05 16:18:18",
"name": "Новая система учёта и сбыта",
"description": "Проект по переходу на новую систему учёта и сбыта продукции",
"code": "123",
"externalCode": "fbeuf21dof1f",
"archived": false,
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ddff1ee8-12c1-11e6-9464-e4de0000007a",
"name": "Приоритет проекта",
"type": "string",
"value": "Крайне высокий"
}
]
}
Настройки компании
На данный момент можно только получить информацию о текущих настройках компании и типах цен товаров. Создавать новые настройки или изменять существующие пока невозможно.
Настройки компании
Атрибуты сущности
- meta - Метаданные о Настройках компании
- currency - Ссылка на стандартную валюту в формате Метаданных
- priceTypes - коллекция всех существующих типов цен.
- discountStrategy - Cовместное применение скидок. Может принимать значения
[bySum, byPriority]означающие "Сумма скидок" и "Приоритетная" соответственно.Необходимое- "Сумма скидок"
[bySum]означает, что должна действовать сумма скидок - "Приоритетная"
[byPriority]должна действовать одна, наиболее выгодная для покупателя скидка
- "Сумма скидок"
Тип цены:
Структура отдельного объекта, представляющего тип цены:
+ meta - Метаданные о Типе цены Только для чтения
+ id - ID в формате UUID Только для чтения
+ name - Наименование Типа цены Необходимое
+ externalCode - Внешний код Типа цены
Метаданные настроек
В метаданных Настроек компании, в поле customEntities показан список пользовательских справочников. Каждый пользовательский справочник содержит поля: + meta - Ссылка на представление пользовательского справочника + entityMeta - Ссылка на список сущностей данного пользовательского справочника + name - Наименование справочника
Получить Настройки компании
Запрос на получение Настроек компании.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/context/companysettings"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Настроек компании.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata",
"type": "companysettings",
"mediaType": "application/json"
},
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/45ffbac2-24a5-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
},
"id": "45ffbac2-24a5-11e6-8a84-bae500000055",
"system": true,
"name": "руб",
"fullName": "Российский рубль",
"rate": 1,
"multiplicity": 1,
"indirect": false,
"rateUpdateType": "manual",
"code": "643",
"isoCode": "RUB",
"majorUnit": {
"gender": "masculine",
"s1": "рубль",
"s2": "рубля",
"s5": "рублей"
},
"minorUnit": {
"gender": "feminine",
"s1": "копейка",
"s2": "копейки",
"s5": "копеек"
},
"archived": false,
"default": true
},
"priceTypes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f2222",
"name": "Цена для друзей",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f432222"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f4444",
"name": "Цена для конкурентов",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f434444"
}
],
"discountStrategy": "bySum"
}
Метаданные настроек компании
Получить метаданные настроек компании
Запрос на получение метаданных Настроек компании.
curl -X GET
"ttps://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных настроек компании.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings",
"mediaType": "application/json"
},
"customEntities": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/eaacabaf-2655-11e6-8a84-bae500000045",
"type": "customentitymetadata",
"mediaType": "application/json"
},
"name": "Партнёры",
"createShared": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/f3aff189-2655-11e6-8a84-bae500000046",
"type": "customentitymetadata",
"mediaType": "application/json"
},
"name": "Рекламные агенства",
"createShared": true
}
]
}
Статья расходов
Статьи расходов
Средствами JSON API можно запрашивать списки Статей расходов и сведения по отдельным Статьям расходов. Кодом сущности для Статей расходов в составе JSON API является ключевое слово expenseitem. Больше о Статьях расходов и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по
этой ссылке.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов Статей расходов на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию Cтатьи расходов name + по описанию Cтатьи расходов description
Атрибуты сущности
- meta - Метаданные о Статье расходов
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - Момент последнего обновления сущности
Только для чтения - name - Наименование Статьи расходов
Необходимое - description - Описание Статьи расходов
- code - Код Статьи расходов
- externalCode - Внешний код Статьи расходов
- archived - Добавлена ли Статья расходов в архив
Получить Статьи расходов
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение списка статей расходов.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/expenseitem"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Статей расходов.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json",
"size": 8,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "1be2350e-0479-11e5-b03a-448a5b426e7e",
"updated": "2015-05-27 17:03:10",
"name": "Закупка товаров",
"description": "Расходы на закупку товаров учитываются в отчете «Прибыли и убытки» как себестоимость проданных товаров",
"code": "1",
"externalCode": "1"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2395a-0479-11e5-baee-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "1be2395a-0479-11e5-baee-448a5b426e7e",
"updated": "2015-05-27 17:03:10",
"name": "Возврат",
"description": "Расходы по возвратам не учитываются в отчете «Прибыли и убытки»",
"code": "3",
"externalCode": "3"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be23a18-0479-11e5-a260-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "1be23a18-0479-11e5-a260-448a5b426e7e",
"updated": "2015-05-27 17:03:10",
"name": "Налоги и сборы",
"description": "Расходы по налогам и сборам учитываются как отдельная статья, не включенная в операционные расходы",
"code": "2",
"externalCode": "2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/23f05a1e-0479-11e5-8bb9-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "23f05a1e-0479-11e5-8bb9-448a5b426e7e",
"updated": "2015-05-27 17:03:24",
"name": "Списания",
"description": "Списания",
"code": "4",
"externalCode": "4"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/82031d62-2e58-11e6-ab5c-d8cb8a84bae5",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "82031d62-2e58-11e6-ab5c-d8cb8a84bae5",
"updated": "2016-06-09 18:40:35",
"name": "Перемещение",
"description": "Перемещения денег между кассами не учитываются в отчете «Прибыли и убытки».",
"code": "5",
"externalCode": "5"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/fb0a4b75-2e58-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "fb0a4b75-2e58-11e6-8a84-bae500000058",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-06-09 18:43:58",
"name": "Аренда",
"description": "Аренда",
"code": "Аренда",
"externalCode": "IVslr34uhCUuglxPD7Idm0"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/fb0c8620-2e58-11e6-8a84-bae500000059",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "fb0c8620-2e58-11e6-8a84-bae500000059",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-06-09 18:43:58",
"name": "Зарплата",
"description": "Зарплата",
"code": "Зарплата",
"externalCode": "RY7G3TULiTyjqYRrzr3V03"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/fb0dc966-2e58-11e6-8a84-bae50000005a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "fb0dc966-2e58-11e6-8a84-bae50000005a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-06-09 18:43:58",
"name": "Маркетинг и реклама",
"description": "Маркетинг и реклама",
"code": "Маркетинг и реклама",
"externalCode": "1PMtKJq-jjVJQbu5OWqBG1"
}
]
}
Создать Статью расходов
Запрос на создание новой статьи расходов. Обязательное поле для создание статьи расходов - name.
Пример запроса на создание новой статьи расходов.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/expenseitem"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Налоги и не налоги",
"description": "Статья расходов налоги",
"code": "nalogi",
"externalCode": "wwoaon21431"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной статьи расходов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/76e88dff-3f9b-11e6-8a84-bae50000009b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "76e88dff-3f9b-11e6-8a84-bae50000009b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-07-01 17:52:42",
"name": "Налоги и не налоги",
"description": "Статья расходов налоги",
"code": "nalogi",
"externalCode": "wwoaon21431"
}
Массовое создание и обновление Статей расходов
Массовое создание и обновление Статей расходов. В теле запроса нужно передать массив, содержащий JSON представления Статей расходов, которые вы хотите создать или обновить. Обновляемые Статьи расходов должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Статей расходов
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/expenseitem"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "Налоги и не налоги",
"description": "Статья расходов налоги",
"code": "nalogi",
"externalCode": "wwoaon21431"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"name": "Дополнительные расходы",
"description": "Еще дополнительные расходы",
"code": "additional",
"externalCode": "sdeEfr32rfe"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Статей расходов.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/76e88dff-3f9b-11e6-8a84-bae50000009b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "76e88dff-3f9b-11e6-8a84-bae50000009b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-07-01 17:52:42",
"name": "Налоги и не налоги",
"description": "Статья расходов налоги",
"code": "nalogi",
"externalCode": "wwoaon21431"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "7944ef04-f831-11e5-7a69-971500188b19",
"accountId": "7944ef04-f831-11e5-7a69-971500188b19",
"updated": "2016-07-01 17:52:42",
"name": "Дополнительные расходы",
"description": "Еще дополнительные расходы",
"code": "additional",
"externalCode": "sdeEfr32rfe"
}
]
Удалить Статью расходов
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Статьи расходов. |
Запрос на удаление Статьи расходов с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление статьи расходов.
Статья расходов
Работа со статьёй расходов с указанным id.
Получить Статью расходов
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Статьи расходов. |
Запрос на получение статьи расходов с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Статей расходов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/fb0a4b75-2e58-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "fb0a4b75-2e58-11e6-8a84-bae500000058",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-06-09 18:43:58",
"name": "Аренда",
"description": "Аренда",
"code": "Аренда",
"externalCode": "IVslr34uhCUuglxPD7Idm0"
}
Изменить Статью расходов
Запрос на изменение существующей статьи расходов.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Статьи расходов. |
Пример запроса на обновление статьи расходов.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Не налоги и налоги",
"description": "Налоги и не налоги. Такая вот статья",
"code": "nalogi i net",
"externalCode": "wwoa1142aon21431"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой статьи расходов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/76e88dff-3f9b-11e6-8a84-bae50000009b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
},
"id": "76e88dff-3f9b-11e6-8a84-bae50000009b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"updated": "2016-07-01 17:52:42",
"name": "Не налоги и налоги",
"description": "Налоги и не налоги. Такая вот статья",
"code": "nalogi i net",
"externalCode": "wwoa1142aon21431"
}
Страна
Страны
Средствами JSON API можно создавать и обновлять сведения о Странах, запрашивать списки Стран и сведения по отдельным Странам. Кодом сущности для Страны в составе JSON API является ключевое слово country.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов стран на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию Страны name + по описанию Страны description
Атрибуты сущности
- meta - Метаданные о Стране
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - Момент последнего обновления сущности
Только для чтения - shared - Флаг Общий доступ
Только для пользовательских стран - owner - Сотрудник-владелец
Только для пользовательских стран - group - Отдел-владелец
Только для пользовательских стран - name - Наименование Страны
Необходимое - description - Описание Страны
- code - Код Страны
- externalCode - Внешний код Страны
Получить Страны
Запрос на получения списка всех Стран для данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Страны.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить страны
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/country"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Стран.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/?limit=5",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json",
"size": 248,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/000d77a9-3000-4f81-a995-6b9cffdee1d2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "000d77a9-3000-4f81-a995-6b9cffdee1d2",
"updated": "2012-11-02 11:04:13",
"name": "Марокко",
"description": "Королевство Марокко",
"code": "504",
"externalCode": "504"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/00999522-23d6-40e6-870e-ec7f7bd8d354",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "00999522-23d6-40e6-870e-ec7f7bd8d354",
"updated": "2012-11-02 11:04:15",
"name": "Япония",
"code": "392",
"externalCode": "392"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/0238a888-c602-4e78-a199-d8f49c4d6c18",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "0238a888-c602-4e78-a199-d8f49c4d6c18",
"updated": "2012-11-02 11:04:15",
"name": "Хорватия",
"description": "Республика Хорватия",
"code": "191",
"externalCode": "191"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/02dc7934-0a88-49ea-a733-2da517a000c2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "02dc7934-0a88-49ea-a733-2da517a000c2",
"updated": "2012-11-02 11:04:15",
"name": "Филиппины",
"description": "Республика Филиппины",
"code": "608",
"externalCode": "608"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/04cc9c56-96b1-4ccf-aa7f-78735710381c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "04cc9c56-96b1-4ccf-aa7f-78735710381c",
"updated": "2012-11-02 11:04:15",
"name": "Эквадор",
"description": "Республика Эквадор",
"code": "218",
"externalCode": "218"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/04cc9c56-96b1-4ccf-aa7f-78735710381c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"accountId": "95004e42-79f2-11e8-1a0d-4e0d00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9bc5de98-79f2-11e8-1a0d-4e0d0000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=9bc5de98-79f2-11e8-1a0d-4e0d0000002b"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/9504054f-79f2-11e8-1a0d-4e0d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"id": "04cc9c56-96b1-4ccf-aa7f-78735710381c",
"updated": "2012-11-02 11:04:15",
"name": "Моя страна",
"description": "Моя пользовательская страна",
"code": "999",
"externalCode": "999"
}
]
}
Создать Страну
Запрос на создание новой страны на данной учётной записи. Единственное поле, которое обязательно должно присутствовать в теле запроса на создание Страны - поле name.
Пример запроса на создание новой страны.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/country"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Панама 2",
"description": "Мы создали Панаму",
"code": "PanamaCode",
"externalCode": "panamaExtCode"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Страны.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/04331e4f-24c8-11e6-8a84-bae500000016",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "04331e4f-24c8-11e6-8a84-bae500000016",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9bc5de98-79f2-11e8-1a0d-4e0d0000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=9bc5de98-79f2-11e8-1a0d-4e0d0000002b"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/9504054f-79f2-11e8-1a0d-4e0d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-30 09:02:21",
"name": "Панама 2",
"description": "Мы создали Панаму",
"code": "PanamaCode",
"externalCode": "panamaExtCode"
}
Массовое создание и обновление Стран
Массовое создание и обновление Стран. В теле запроса нужно передать массив, содержащий JSON представления Стран, которые вы хотите создать или обновить. Обновляемые Страны должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Стран
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/country"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "Панама 2",
"description": "Мы создали Панаму",
"code": "PanamaCode",
"externalCode": "panamaExtCode"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/810b5344-24ca-11e6-8a84-bae500000018",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"name": "Другая Россия",
"description": "Каждый может изменить Россию, но только если он её создал сам",
"code": "no1russia",
"externalCode": "gogorussia"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Стран.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/04331e4f-24c8-11e6-8a84-bae500000016",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "04331e4f-24c8-11e6-8a84-bae500000016",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9bc5de98-79f2-11e8-1a0d-4e0d0000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=9bc5de98-79f2-11e8-1a0d-4e0d0000002b"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/9504054f-79f2-11e8-1a0d-4e0d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-30 09:02:21",
"name": "Панама 2",
"description": "Мы создали Панаму",
"code": "PanamaCode",
"externalCode": "panamaExtCode"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/810b5344-24ca-11e6-8a84-bae500000018",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "810b5344-24ca-11e6-8a84-bae500000018",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9bc5de98-79f2-11e8-1a0d-4e0d0000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=9bc5de98-79f2-11e8-1a0d-4e0d0000002b"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/9504054f-79f2-11e8-1a0d-4e0d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-30 09:20:10",
"name": "Другая Россия",
"description": "Каждый может изменить Россию, но только если он её создал сам",
"code": "no1russia",
"externalCode": "gogorussia"
}
]
Удалить Страну
Запрос на удаление страны. Невозможно удаление предустановленных стран (стран имеющихся на учётной записи по умолчанию). Удалить можно только страны, созданные через основной интерфейс или через метод POST.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Страны. |
Удалить Страну
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/country/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Розничной продажи.
Страна
Параметры
| Параметр | Описание |
|---|---|
| id | 7944ef04-f831-11e5-7a69-971500188b19 (required, string) - id Страны |
Получить Страну
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Страны. |
Запрос на получение страны с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/country/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Страны с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/000d77a9-3000-4f81-a995-6b9cffdee1d2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "000d77a9-3000-4f81-a995-6b9cffdee1d2",
"updated": "2012-11-02 11:04:13",
"name": "Марокко",
"description": "Королевство Марокко",
"code": "504",
"externalCode": "504"
}
Изменить Страну
Запрос на изменение объекта, представляющего собой страну. Невозможно изменение предустановленных стран (стран имеющихся на учётной записи по умолчанию). Изменить можно только страны, созданные через основной интерфейс или через метод POST.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Страны. |
Пример запроса на обновление страны.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/country/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Другая Россия",
"description": "Каждый может изменить Россию, но только если он её создал сам",
"code": "no1russia",
"externalCode": "gogorussia"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Страны.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/810b5344-24ca-11e6-8a84-bae500000018",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
},
"id": "810b5344-24ca-11e6-8a84-bae500000018",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9bc5de98-79f2-11e8-1a0d-4e0d0000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=9bc5de98-79f2-11e8-1a0d-4e0d0000002b"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/9504054f-79f2-11e8-1a0d-4e0d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-30 09:20:10",
"name": "Другая Россия",
"description": "Каждый может изменить Россию, но только если он её создал сам",
"code": "no1russia",
"externalCode": "gogorussia"
}
Отдел
Отделы
Средствами JSON API можно запрашивать списки Отделов и сведения по отдельным Отделам. Кодом сущности для Отдела в составе JSON API является ключевое слово group.
Больше об Отделах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов отделов на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию Отдела name
Атрибуты сущности
- meta - Метаданные об Отделе
- name - Наименование отдела.
Получить Отделы
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение всех отделов на данной учётной записи.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/group"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка отделов.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
},
"name": "Основной"
}
]
}
Отдел
Получить Отдел
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Отдела. |
Запрос на получение отдельного отдела с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/group/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного отдела.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
},
"name": "Основной"
}
Скидки
Скидки
Кодом сущности для Скидок в составе JSON API является ключевое слово discount. Операции создания, изменения и удаления не поддерживаются. Перед работой со скидками настоятельно рекомендуем вам прочитать вот эту статью на портале поддержки МоегоСклада.
Атрибуты сущности
Общие поля
- meta - Метаданные
- id - ID скидки в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - name - Наименование скидки
- active - Индикатор, является ли скидка активной на данный момент
- allProducts - Индикатор, действует ли скидка на все товары
- agentTags - Тэги контрагентов, к которым применяется скидка, если применяется не ко всем контрагентам
- assortment - Товары и услуги, которые были выбраны для применения скидки, если та применяется не ко всем товарам
- meta - метаданные товара или услуги _____ #### Поля Спец. цен
- productfolders - Группы товаров, к которым применяется скидка, если применяется не ко всем товарам
- meta - метаданные папки
- discount - Процент скидки если выбран фиксированный процент
- specialPrice - Спец. цена (если выбран тип цен)
- priceType - Наименование типа цены
- value - Значение цены, если выбрано фиксированное значение
Поля накопительных скидок
- productfolders - Группы товаров, к которым применяется скидка, если применяется не ко всем товарам
- meta - метаданные папки
- levels - проценты скидок при определённой сумме продаж
- amount - Сумма накоплений в копейках
- discount - Процент скидки, соответствующий данной сумме
Получить все скидки
Запрос на получение всех скидок учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой скидки.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить все скидки
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/discount"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - список всех скидок всех типов для учетной записи.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/discount",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/discount/metadata",
"type": "discount",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/personaldiscount/0623d6b4-9ceb-11e6-8af5-581e00000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/personaldiscount/metadata",
"type": "personaldiscount",
"mediaType": "application/json"
},
"id": "0623d6b4-9ceb-11e6-8af5-581e00000003",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"name": "Персональная скидка",
"active": true,
"allProducts": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/specialpricediscount/96673f4d-9f4d-11e6-8af5-581e0000007b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/specialpricediscount/metadata",
"type": "specialpricediscount",
"mediaType": "application/json"
},
"id": "96673f4d-9f4d-11e6-8af5-581e0000007b",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"name": "Специальная процентная сидка",
"active": true,
"agentTags": [
"группа агентов"
],
"allProducts": false,
"assortment": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/9881531b-9a09-11e6-8af5-581e00000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
],
"discount": 5
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/specialpricediscount/bd1235f2-9c60-11e6-8af5-581e00000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/specialpricediscount/metadata",
"type": "specialpricediscount",
"mediaType": "application/json"
},
"id": "bd1235f2-9c60-11e6-8af5-581e00000009",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"name": "Скидка номер 2",
"active": true,
"allProducts": false,
"productFolders": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/a7a589e5-9c60-11e6-8af5-581e00000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
}
}
],
"assortment": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/9881531b-9a09-11e6-8af5-581e00000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
],
"specialPrice": {
"value": 15,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/accumulationdiscount/dce08f7f-9a09-11e6-8af5-581e0000007e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/accumulationdiscount/metadata",
"type": "accumulationdiscount",
"mediaType": "application/json"
},
"id": "dce08f7f-9a09-11e6-8af5-581e0000007e",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"name": "Скидки на сапоги",
"active": true,
"allProducts": false,
"assortment": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/987d77f1-9a09-11e6-8af5-581e00000074",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/9881531b-9a09-11e6-8af5-581e00000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
],
"levels": [
{
"amount": 100000,
"discount": 10
},
{
"amount": 200000,
"discount": 15
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/1223d051-ba76-11e8-3353-995e0000005a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=1223d051-ba76-11e8-3353-995e0000005a"
},
"id": "1223d051-ba76-11e8-3353-995e0000005a",
"accountId": "dbb8cfc1-cbfa-11e1-6dfb-889ffa6f49fd",
"name": "test",
"active": true,
"earnRateRoublesToPoint": 1,
"spendRatePointsToRouble": 1,
"maxPaidRatePercents": 100
}
]
}
Единица измерения
Единицы измерения
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов единиц измерения на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию Единицы измерения name + по описанию Единицы измерения description
Атрибуты сущности
- meta - Метаданные о единице измерения
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - Момент последнего обновления сущности
Только для чтения - shared - Флаг Общий доступ
Только для пользовательских единиц измерений - owner - Сотрудник-владелец
Только для пользовательских единиц измерений - group - Отдел-владелец
Только для пользовательских единиц измерений - name - Наименование единицы измерения
Необходимое - description - Описание единицы измерения
- code - Код единицы измерения
- externalCode - Внешний код единицы измерения
Получить Единицы измерения
Запрос на получения списка всех единиц измерения для данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Единицы измерения.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Единицы измерения
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/uom"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка единиц измерения.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom?limit=5",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json",
"size": 60,
"limit": 5,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/061721df-9197-49a5-b637-7f5b4d3be969",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "061721df-9197-49a5-b637-7f5b4d3be969",
"updated": "2012-11-02 11:07:44",
"name": "дюйм",
"description": "Дюйм (25,4 мм)",
"code": "039",
"externalCode": "039"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/0dd4fe8b-e59e-486e-bde5-b52fe0e25415",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "0dd4fe8b-e59e-486e-bde5-b52fe0e25415",
"updated": "2012-11-02 11:07:44",
"name": "мес",
"description": "Месяц",
"code": "362",
"externalCode": "362"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/151af5a2-3df9-4aca-851c-814c8b3a65e6",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "151af5a2-3df9-4aca-851c-814c8b3a65e6",
"updated": "2012-11-02 11:07:44",
"name": "ц",
"description": "Центнер (метрический) (100 кг); гектокилограмм; квинтал1 (метрический); децитонна",
"code": "206",
"externalCode": "206"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/1700dfba-e9e7-4c98-9857-8d984ab48b2b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "1700dfba-e9e7-4c98-9857-8d984ab48b2b",
"updated": "2012-11-02 11:07:44",
"name": "ч",
"description": "Час",
"code": "356",
"externalCode": "356"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"updated": "2012-11-02 11:07:44",
"name": "шт",
"description": "Штука",
"code": "796",
"externalCode": "796"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/79e6d170-7df6-11e8-7e04-3e5a00000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "79e6d170-7df6-11e8-7e04-3e5a00000097",
"accountId": "1902785b-7df4-11e8-7e04-3e5a00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/1fe747fc-7df4-11e8-7e04-3e5a0000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=1fe747fc-7df4-11e8-7e04-3e5a0000002d"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/19062b38-7df4-11e8-7e04-3e5a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-07-02 15:50:19",
"name": "Попугаи",
"description": "Для измерения удавов",
"code": "papagei",
"externalCode": "parrotUnitOfMeasure"
}
]
}
Создать Единицу измерения
Запрос на создание новой единицы измерения на данной учётной записи. Единственное поле, которое обязательно должно присутствовать в теле запроса на создание Единицы измерения - поле name.
Пример запроса на создание новой единицы измерения.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/uom"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Попугаи",
"description": "Для измерения удавов",
"code": "papagei",
"externalCode": "parrotUnitOfMeasure"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной единицы измерения.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/b25681fd-24d0-11e6-8a84-bae500000019",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "b25681fd-24d0-11e6-8a84-bae500000019",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/1fe747fc-7df4-11e8-7e04-3e5a0000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=1fe747fc-7df4-11e8-7e04-3e5a0000002d"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/19062b38-7df4-11e8-7e04-3e5a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-30 10:04:29",
"name": "Попугаи",
"description": "Для измерения удавов",
"code": "papagei",
"externalCode": "parrotUnitOfMeasure"
}
Массовое создание и обновление единиц измерения
Массовое создание и обновление единиц измерения. В теле запроса нужно передать массив, содержащий JSON представления единиц измерения, которые вы хотите создать или обновить. Обновляемые единицы измерения должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких единиц измерения
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/uom"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "Попугаи",
"description": "Для измерения удавов",
"code": "papagei",
"externalCode": "parrotUnitOfMeasure"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/01be5f70-24d1-11e6-8a84-bae50000001a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "Попугай",
"description": "Для точного измерения удавов",
"code": "papagai",
"externalCode": "papagaitUnitOfMeasure"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных единиц измерения.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/b25681fd-24d0-11e6-8a84-bae500000019",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "b25681fd-24d0-11e6-8a84-bae500000019",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"updated": "2016-05-30 10:04:29",
"name": "Попугаи",
"description": "Для измерения удавов",
"code": "papagei",
"externalCode": "parrotUnitOfMeasure"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/01be5f70-24d1-11e6-8a84-bae50000001a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "01be5f70-24d1-11e6-8a84-bae50000001a",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/1fe747fc-7df4-11e8-7e04-3e5a0000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=1fe747fc-7df4-11e8-7e04-3e5a0000002d"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/19062b38-7df4-11e8-7e04-3e5a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-30 10:06:42",
"name": "Попугай",
"description": "Для точного измерения удавов",
"code": "papagai",
"externalCode": "papagaitUnitOfMeasure"
}
]
Удалить Единицу измерения
Запрос на удаление единицы измерения. Невозможно удаление предустановленных единиц измерения (единиц измерений имеющихся на учётной записи по умолчанию). Удалить можно только единицы измерения, созданные через основной интерфейс или через метод POST.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Единицы измерения. |
Удалить Единицу измерения
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/uom/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Розничной продажи.
Единица измерения
Получить Единицу измерения
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Единицы измерения. |
Запрос на получение единицы измерения с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/uom/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Единицы измерения с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/061721df-9197-49a5-b637-7f5b4d3be969",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "061721df-9197-49a5-b637-7f5b4d3be969",
"updated": "2012-11-02 11:07:44",
"name": "дюйм",
"description": "Дюйм (25,4 мм)",
"code": "039",
"externalCode": "039"
}
Изменить Единицу измерения
Запрос на изменение объекта, представляющего собой единицу измерения. Невозможно изменение предустановленных единиц измерения (единиц измерения имеющихся на учётной записи по умолчанию). Изменить можно только единицы измерения, созданные через основной интерфейс или через метод POST.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Единицы измерения. |
Пример запроса на обновление новой единицы измерения.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/uom/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Попугай",
"description": "Для точного измерения удавов",
"code": "papagai",
"externalCode": "papagaitUnitOfMeasure"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Единицы измерения.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/01be5f70-24d1-11e6-8a84-bae50000001a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"id": "01be5f70-24d1-11e6-8a84-bae50000001a",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/1fe747fc-7df4-11e8-7e04-3e5a0000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=1fe747fc-7df4-11e8-7e04-3e5a0000002d"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/19062b38-7df4-11e8-7e04-3e5a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-30 10:06:42",
"name": "Попугай",
"description": "Для точного измерения удавов",
"code": "papagai",
"externalCode": "papagaitUnitOfMeasure"
}
Сотрудник
Сотрудники
Средствами JSON API можно запрашивать списки Сотрудников и сведения по отдельным Сотрудникам. Кодом сущности для Сотрудника в составе JSON API является ключевое слово employee. Больше о Сотрудниках и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке.
Поиск среди объектов сотрудников на соответствие поисковой строке будет осуществлён по следующим полям: + По имени Сотрудника name + По адресу электронной почты email + По номеру телефона phone
Атрибуты сущности
- meta - Метаданные о Сотруднике
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
Только для чтения - shared - Общий доступ
Только для чтения - group - Отдел сотрудника в формате Метаданных
Только для чтения - updated - Момент последнего обновления сущности
Только для чтения - name - Имя сотрудника в формате "Фамилия И. О."
Только для чтения - description - Комментарий к Сотруднику
- externalCode - Внешний код Сотрудника
Только для чтения - archived - Добавлен Сотрудник в архив
Только для чтения - created - Момент создания Сотрудника
Только для чтения - uid - Логин Сотрудника
Только для чтения - email - Электронна почта сотрудника
Только для чтения - phone - Телефон сотрудника
- firstName - Имя
- middleName - Отчество
- lastName - Фамилия
Необходимое - fullName - Имя Отчество Фамилия
Только для чтения - shortFio - Краткое ФИО
Только для чтения - cashiers - Массив кассиров
Только для чтения - attributes - Дополнительные поля Сотрудника в формате Метаданных
- image - Фотография сотрудника
- inn - ИНН сотрудника (в формате ИНН физического лица)
- position - Должность сотрудника
Атрибуты вложенных сущностей
Кассир
- id - id Кассира
Только для чтения - accountId - id учетной записи Кассира
Только для чтения - employee - Ссылка на сущность Сотрудника, которого представляет собой кассир в формате Метаданных
Только для чтения - retailStore - Ссылка на Точку продаж, к которой прикреплён кассир в формате Метаданных
Только для чтения
Фотография сотрудника: структура и загрузка.
Структура поля image, которое вы получите при запросе сотрудника с фотографией: + meta - Метаданные об изображении + title - Название изображения + filename - Имя файла + size - Размер файла в байтах + updated - Дата последнего изменения + miniature - Ссылка на миниатюру изображения в формате Метаданных + tiny - Ссылка на уменьшенное изображение в формате Метаданных
Загрузка
Для загрузки фотографии сотрудника необходимо сформировать запрос на обновление сотрудника (PUT) и в теле запроса указать поле image со следующими атрибутами: + filename - имя файла с расширением. Например - "cashier.png" + content - Изображение, закодированное в формате Base64.
Если в запросе на обновление не будет полей filename и content, то весь объект image, если он присутствует в Body, будет проигнорирован, т.к. сервер посчитает, что его обновление не требуется.
О работе с доп. полями Сотрудников можно прочитать здесь
Получить Сотрудников
Запрос на получения списка всех сотрудников для данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой сотрудников.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Сотрудников
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/employee"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Сотрудников.
{
"context": {
"employee": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/84f88b2f-f504-11e5-8a84-bae500000138",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
},
"id": "84f88b2f-f504-11e5-8a84-bae500000138",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-03-28 19:45:46",
"name": "Администратор",
"externalCode": "4A039QXHgbZdAHdXbcUI71",
"archived": false,
"uid": "admin@reqwy1",
"email": "asdad@sfasf.erq",
"lastName": "Администратор",
"fullName": "Администратор",
"shortFio": "Администратор",
"cashiers": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailstore/8d2f2a2e-d6a1-11e7-9464-e4de00000060/cashiers/8d2f3fe1-d6a1-11e7-9464-e4de00000061",
"type": "cashier",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailstore/53302317-df24-11e7-9464-e4de00000001/cashiers/58dfeb3e-df24-11e7-9464-e4de00000004",
"type": "cashier",
"mediaType": "application/json"
}
}
],
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"inn": "222490425273",
"position": "Директор"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9e00ad58-0302-11e6-9464-e4de00000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
},
"id": "9e00ad58-0302-11e6-9464-e4de00000076",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-15 15:07:25",
"name": "Друганов Л. А.",
"externalCode": "4pGL0jazh3dGTpJfdcP1a1",
"archived": false,
"uid": "employee@company",
"email": "company@company.ru",
"phone": "8 800 250-04-32",
"firstName": "Леонид",
"middleName": "Андреевич",
"lastName": "Друганов",
"fullName": "Леонид Андреевич Друганов",
"shortFio": "Друганов Л. А.",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d49d59bd-12dc-11e6-9464-e4de0000006b",
"name": "КПД",
"type": "long",
"value": 200
}
]
}
]
}
Массовое обновление Сотрудников
Массовое обновление Сотрудников. В теле запроса нужно передать массив, содержащий JSON представления Сотрудников, которые вы хотите обновить. Обновляемые Сотрудники должны содержать идентификатор в виде метаданных.
Пример обновления нескольких Сотрудников
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/employee"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
},
"firstName": "Петр",
"middleName": "Иванович",
"lastName": "Мойскладкин",
"inn": "222490425273",
"position": "Директор"
},
{
"firstName": "Иван",
"middleName": "Петрович",
"lastName": "Мойскладкин"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений обновленных Сотрудников.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
},
"id": "7944ef04-f831-11e5-7a69-971500188b19",
"accountId": "ef07c35a-d1f6-11e8-7a33-904100000002",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ef0887b1-d1f6-11e8-7a33-904100000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-10-17 14:51:30",
"name": "Мойскладкин П. И.",
"externalCode": "wNxghfHlg5n2rJGO9Lpud0",
"archived": false,
"created": "2018-10-17 13:25:14",
"uid": "admin@company",
"email": "company@mail.ru",
"firstName": "Петр",
"middleName": "Иванович",
"lastName": "Мойскладкин",
"fullName": "Петр Иванович Мойскладкин",
"shortFio": "Мойскладкин П. И.",
"cashiers": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/eff1b7cc-d1f6-11e8-7a33-904100000062/cashiers/eff1c76b-d1f6-11e8-7a33-904100000063",
"type": "cashier",
"mediaType": "application/json"
}
}
],
"inn": "222490425273",
"position": "Директор"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/fc86b89c-d202-11e8-7a33-90410000004a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
},
"id": "fc86b89c-d202-11e8-7a33-90410000004a",
"accountId": "ef07c35a-d1f6-11e8-7a33-904100000002",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ef0887b1-d1f6-11e8-7a33-904100000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-10-17 14:51:30",
"name": "Мойскладкин И. П.",
"externalCode": "0freFxtniG9a1MNZ7ADin2",
"archived": false,
"created": "2018-10-17 14:51:30",
"firstName": "Иван",
"middleName": "Петрович",
"lastName": "Мойскладкин",
"fullName": "Иван Петрович Мойскладкин",
"shortFio": "Мойскладкин И. П."
}
]
Удалить Сотрудника
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Сотрудника. |
Запрос на удаление Сотрудника с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/employee/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Сотрудника.
Метаданные Сотрудников
Метаданные Сотрудников
Запрос на получение метаданных Сотрудников. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Сотрудников + attributes - Массив объектов доп. полей Сотрудников в формате Метаданных + createShared - создавать новых Сотрудников с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Сотрудников
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Сотрудников.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
],
"createShared": true
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
Сотрудник
Получить Сотрудника
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Сотрудника. |
Запрос на получение отдельного сотрудника с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/employee/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Сотрудника.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/84f88b2f-f504-11e5-8a84-bae500000138",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
},
"id": "84f88b2f-f504-11e5-8a84-bae500000138",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-03-28 19:45:46",
"name": "Администратор",
"externalCode": "4A039QXHgbZdAHdXbcUI71",
"archived": false,
"uid": "admin@reqwy1",
"email": "asdad@sfasf.erq",
"lastName": "Администратор",
"fullName": "Администратор",
"shortFio": "Администратор",
"cashiers": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailstore/8d2f2a2e-d6a1-11e7-9464-e4de00000060/cashiers/8d2f3fe1-d6a1-11e7-9464-e4de00000061",
"type": "cashier",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailstore/53302317-df24-11e7-9464-e4de00000001/cashiers/58dfeb3e-df24-11e7-9464-e4de00000004",
"type": "cashier",
"mediaType": "application/json"
}
}
],
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d49d59bd-12dc-11e6-9464-e4de0000006b",
"name": "ЗП",
"type": "long",
"value": 200
}
],
"inn": "222490425273",
"position": "Директор"
}
Создать Сотрудника
Запрос на создание сотрудника. Обязательные для создания поля:
- lastName - Фамилия
Пример запроса на создание Сотрудника.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/employee/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"firstName": "Петр",
"middleName": "Иванович",
"lastName": "Мойскладкин",
"inn": "222490425273",
"position": "Директор",
"phone": "+7(999)888-7766",
"description": "Описание",
"attributes": [
{
"id": "ed14b498-cae3-11e8-9dd2-f3a300000044",
"value": "Строковое доп поле"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Сотрудника.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/bc962452-cd64-11e8-ac12-000800000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
},
"id": "bc962452-cd64-11e8-ac12-000800000000",
"accountId": "ffb8f6b1-cd3a-11e8-ac12-000700000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/00f76fbb-cd3b-11e8-ac12-00080000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ffbc0889-cd3a-11e8-ac12-000700000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-10-11 17:48:37",
"name": "Мойскладкин П. И.",
"description": "Описание",
"externalCode": "tJfzU8g2hVgXFOiFGTMIe3",
"archived": false,
"created": "2018-10-11 17:48:37",
"phone": "+7(999)888-7766",
"firstName": "Петр",
"middleName": "Иванович",
"lastName": "Мойскладкин",
"fullName": "Петр Иванович Мойскладкин",
"shortFio": "Мойскладкин П. И.",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata/attributes/ed14b498-cae3-11e8-9dd2-f3a300000044",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ed14b498-cae3-11e8-9dd2-f3a300000044",
"name": "Название",
"type": "string",
"value": "Строковое доп поле"
}
],
"inn": "222490425273",
"position": "Директор"
}
Изменить Сотрудника
Запрос на обновление существующего Сотрудника. В теле запроса обязательно следует указать поле lastName.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Сотрудника. |
Пример запроса на обновление Сотрудника.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/employee/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"firstName": "Петр",
"middleName": "Иванович",
"lastName": "Мойскладкин",
"inn": "222490425273",
"position": "Директор",
"phone": "+7(999)888-7766",
"description": "Описание",
"attributes": [
{
"id": "ed14b498-cae3-11e8-9dd2-f3a300000044",
"value": "Строковое доп поле"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Сотрудника.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
},
"id": "7944ef04-f831-11e5-7a69-971500188b19",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-03-28 19:45:46",
"name": "Мойскладкин П. И.",
"description": "Описание",
"externalCode": "4A039QXHgbZdAHdXbcUI71",
"archived": false,
"phone": "+7(999)888-7766",
"uid": "admin@reqwy1",
"email": "asdad@sfasf.erq",
"firstName": "Петр",
"middleName": "Иванович",
"lastName": "Мойскладкин",
"fullName": "Петр Иванович Мойскладкин",
"shortFio": "Мойскладкин П. И.",
"cashier": {
"id": "851fa2f7-f504-11e5-8a84-bae50000016d",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d49d59bd-12dc-11e6-9464-e4de0000006b",
"name": "ЗП",
"type": "long",
"value": 200
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata/attributes/ed14b498-cae3-11e8-9dd2-f3a300000044",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ed14b498-cae3-11e8-9dd2-f3a300000044",
"name": "Строка",
"type": "string",
"value": "Строковое доп поле"
}
],
"inn": "222490425273",
"position": "Директор"
}
Пользовательский справочник
Пользовательские справочники
Атрибуты сущности
- meta - Метаданные о Пользовательском справочнике
- id - ID в формате UUID
Только для чтения - name - Наименование пользовательского справочника
Необходимое
Список пользовательских справочников
Для работы с пользовательскими справочниками вам нужно знать id каждого справочника.
Этот id обозначен в URI-параметрах запросов к данной сущности как / и является идентификатором для данного справочника.
+ Пример: Выполнив вышеуказанный запрос и найдя среди списка справочника интересующих нас, мы вычленяем следующую ссылку
из поля meta: https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/eaacabaf-2655-11e6-8a84-bae500000045
Из данной сылки вычленяем eaacabaf-2655-11e6-8a84-bae500000045 и этот id используем
для работы с данным пользовательским справочником в рамках ресурса Пользовательский справочник.
Создать справочник
Единственным необходимым полем для создания пользовательского справочника является поле name.
Пример запроса на создание новой сущности пользовательского справочника.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customentity"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "custom dictionary"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной сущности пользовательского справочника.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/3f9a2f30-76af-11e7-6adb-ede50000000b",
"type": "customentity",
"mediaType": "application/json"
},
"id": "3f9a2f30-76af-11e7-6adb-ede50000000b",
"name": "custom dictionary"
}
Изменить справочник
Запрос на изменение справочника.
Параметры
| Параметр | Описание |
|---|---|
| metadata_id | string (required) Example: 3f9a2f30-76af-11e7-6adb-ede50000000b id пользовательского справочника. |
Request Пример (application/json) Пример запроса на обновление пользовательского справочника.
curl -X PUT
"ttps://online.moysklad.ru/api/remap/1.2/entity/customentity/3f9a2f30-76af-11e7-6adb-ede50000000b"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "new name"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого пользовательского справочника.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/3f9a2f30-76af-11e7-6adb-ede50000000b",
"type": "customentity",
"mediaType": "application/json"
},
"id": "3f9a2f30-76af-11e7-6adb-ede50000000b",
"name": "new name"
}
Удалить справочник
Запрос на удаление пользовательского справочника.
Параметры
| Параметр | Описание |
|---|---|
| metadata_id | string (required) Example: 3f9a2f30-76af-11e7-6adb-ede50000000b id пользовательского справочника. |
Удалить справочник
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/customentity/3f9a2f30-76af-11e7-6adb-ede50000000b"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление пользовательского справочника.
Элементы Пользовательского справочника
Атрибуты элемента
- meta - Метаданные об элементе Пользовательского справочника
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - дата последнего изменения
Только для чтения - name - Наименование элемента пользовательского справочника
Необходимое - code - Код элемента пользовательского справочника
- description - Описание элемента пользовательского справочника
- externalCode - Внешний элемента код пользовательского справочника
Получить элементы справочника
Запрос на получение всех элементов в указанном пользовательском справочнике. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой элементы пользовательского справочника.
Параметры
| Параметр | Описание |
|---|---|
| metadata_id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id пользовательского справочника. |
Получить элементы справочника
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка элементов пользовательского справочника.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/metadata",
"type": "customentity",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#custom_7944ef04-f831-11e5-7a69-971500188b19",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/01b29035-2656-11e6-8a84-bae500000048",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/7944ef04-f831-11e5-7a69-971500188b19",
"type": "customentity",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#custom_7944ef04-f831-11e5-7a69-971500188b19/edit?id=01b29035-2656-11e6-8a84-bae500000048"
},
"id": "01b29035-2656-11e6-8a84-bae500000048",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"updated": "2017-08-13 17:55:08",
"name": "Партнёр1",
"code": "partner1",
"externalCode": "5434665867876"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/3fbe37f2-2659-11e6-8a84-bae500000013",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/7944ef04-f831-11e5-7a69-971500188b19",
"type": "customentity",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#custom_7944ef04-f831-11e5-7a69-971500188b19/edit?id=3fbe37f2-2659-11e6-8a84-bae500000013"
},
"id": "3fbe37f2-2659-11e6-8a84-bae500000013",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"updated": "2017-08-13 11:06:23",
"name": "Партнёр 2",
"externalCode": "5434665867877"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/6343f631-265d-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/7944ef04-f831-11e5-7a69-971500188b19",
"type": "customentity",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#custom_7944ef04-f831-11e5-7a69-971500188b19/edit?id=6343f631-265d-11e6-8a84-bae500000014"
},
"id": "6343f631-265d-11e6-8a84-bae500000014",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"updated": "2017-08-14 10:22:51",
"name": "Пётр михалыч из ООО Предприятие",
"code": "partner mikhalych",
"description": "Ключевой сотрудник ООО Предприятие",
"externalCode": "5434665867878"
}
]
}
Создать элемент справочника
Единственным необходимым полем для создания элемента пользовательского справочника является поле name.
Параметры
| Параметр | Описание |
|---|---|
| metadata_id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id пользовательского справочника. |
Пример запроса на создание нового элемента пользовательского справочника.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Партнёр 3",
"code": "partner3",
"description": "Описание",
"externalCode": "5434665867876"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного элемента пользовательского справочника.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/6343f631-265d-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/7944ef04-f831-11e5-7a69-971500188b19",
"type": "customentity",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#custom_7944ef04-f831-11e5-7a69-971500188b19/edit?id=6343f631-265d-11e6-8a84-bae500000014"
},
"id": "6343f631-265d-11e6-8a84-bae500000014",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"updated": "2017-08-15 09:35:11",
"name": "Партнёр 3",
"code": "partner3",
"description": "Описание",
"externalCode": "5434665867876"
}
Удалить элемент справочника
Запрос на удаление элемента пользовательского справочника.
Параметры
| Параметр | Описание |
|---|---|
| metadata_id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id пользовательского справочника. |
| id | string (required) Example: 6343f631-265d-11e6-8a84-bae500000014 id элемента пользовательского справочника. |
Удалить элемент справочника
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/6343f631-265d-11e6-8a84-bae500000014"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление элемента пользовательского справочника.
Элемент пользовательского справочника
Получить элемент
Параметры
| Параметр | Описание |
|---|---|
| metadata_id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id пользовательского справочника. |
| id | string (required) Example: 6343f631-265d-11e6-8a84-bae500000014 id элемента пользовательского справочника. |
Запрос на получение элемента пользовательского справочника с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/6343f631-265d-11e6-8a84-bae500000014"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление элемента пользовательского справочника с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/6343f631-265d-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/7944ef04-f831-11e5-7a69-971500188b19",
"type": "customentity",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#custom_7944ef04-f831-11e5-7a69-971500188b19/edit?id=6343f631-265d-11e6-8a84-bae500000014"
},
"id": "6343f631-265d-11e6-8a84-bae500000014",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"updated": "2017-08-14 10:22:51",
"name": "Партнёр 3",
"code": "partner3",
"description": "Описание",
"externalCode": "5434665867876"
}
Изменить элемент
Запрос на изменение объекта, представляющего собой элемент пользовательского справочника.
Параметры
| Параметр | Описание |
|---|---|
| metadata_id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id пользовательского справочника. |
| id | string (required) Example: 6343f631-265d-11e6-8a84-bae500000014 id элемента пользовательского справочника. |
Пример запроса на обновление элемента пользовательского справочника.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/6343f631-265d-11e6-8a84-bae500000014"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Пётр михалыч из ООО Предприятие",
"code": "partner mikhalych",
"description": "Ключевой сотрудник ООО Предприятие",
"externalCode": "5434665867876"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого элемента пользовательского справочника.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customentity/7944ef04-f831-11e5-7a69-971500188b19/6343f631-265d-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/7944ef04-f831-11e5-7a69-971500188b19",
"type": "customentity",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#custom_7944ef04-f831-11e5-7a69-971500188b19/edit?id=6343f631-265d-11e6-8a84-bae500000014"
},
"id": "6343f631-265d-11e6-8a84-bae500000014",
"accountId": "45489428-24a5-11e6-8a84-bae500000001",
"updated": "2017-08-15 09:39:34",
"name": "Пётр михалыч из ООО Предприятие",
"code": "partner mikhalych",
"description": "Ключевой сотрудник ООО Предприятие",
"externalCode": "5434665867876"
}
Склад
Склады
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке.
Поиск среди объектов складов на соответствие поисковой строке будет осуществлён по следующим полям: + По наименованию Склада name + По коду Склада code
Атрибуты сущности
- meta - Метаданные о Складе
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- updated - Момент последнего обновления сущности
Только для чтения - name - Наименование Склада
Необходимое - description - комментарий к Складу
- code - Код Склада
- externalCode - Внешний код Склада
- archived - Добавлен ли Склад в архив
- address - Адрес Склада
- parent - Родительский склад (Группа)
- pathName - Группа Склада
- attributes - Дополнительные поля Склада в формате Метаданных
О работе с доп. полями Складов можно прочитать здесь
Получить Склады
Получить список всех Складов. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Склады.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Склады
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/store"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Складов.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/caf46ce5-0569-11e6-9464-e4de00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "caf46ce5-0569-11e6-9464-e4de00000000",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 16:31:01",
"name": "002",
"externalCode": "y7ztWINfjXinPToFMqQid2",
"archived": false,
"pathName": "",
"address": ""
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "850ee995-f504-11e5-8a84-bae500000160",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-03-28 19:45:46",
"name": "Основной склад",
"externalCode": "OJ8pY2FgjQ3ncLVvvpqyw1",
"archived": false,
"pathName": "",
"address": "",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "3a85cfe3-12c5-11e6-9464-e4de00000087",
"name": "Площадь",
"type": "long",
"value": 4400
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/6ebb9094-056a-11e6-9464-e4de000000b4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "6ebb9094-056a-11e6-9464-e4de000000b4",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 16:35:36",
"name": "Подскладик",
"code": "ZAATY643",
"externalCode": "d8Ew2hCDiTuJFb0Ya45tH0",
"archived": false,
"pathName": "002",
"address": "Адрес подскладика"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/95dcda62-056b-11e6-9464-e4de000000b7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "95dcda62-056b-11e6-9464-e4de000000b7",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 16:43:51",
"name": "Склад1",
"description": "Основной склад",
"code": "113AB79",
"externalCode": "fQPIOtxjg-FaeZNKcLx6B3",
"archived": false,
"pathName": "Основной склад",
"address": "МО Одинцово ул Ленина д51 к 39"
}
]
}
Создать Склад
Создать новый Склад.
Описание
Склад создаётся на основе переданного объекта JSON,
который содержит представление нового Склада.
Необходимое для создания поле - name не должно быть пустым.
Пример запроса на создание нового Склада.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/store"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"address": "г Москва ул Вавилова 19 к 116",
"pathName": "Основной склад",
"name": "Склад2",
"code": "code3",
"externalCode": "sfksjafwuiw1sf32141"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Склада.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/0c8de58c-056c-11e6-9464-e4de00000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "0c8de58c-056c-11e6-9464-e4de00000003",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 16:47:10",
"name": "Склад2",
"code": "code3",
"externalCode": "sfksjafwuiw1sf32141",
"archived": false,
"pathName": "",
"address": "г Москва ул Вавилова 19 к 116"
}
Пример запроса на создание нового Склада с доп. полями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/store"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"address": "г Уфа ул Жукова 19",
"pathName": "Основной склад",
"name": "Склад3",
"code": "code4",
"externalCode": "223ddxzv223",
"attributes": [
{
"id": "3a85cfe3-12c5-11e6-9464-e4de00000087",
"value": 4000
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Склада.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/7a6a11b6-12c5-11e6-9464-e4de00000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "7a6a11b6-12c5-11e6-9464-e4de00000006",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-05 16:30:05",
"name": "Склад3",
"code": "code4",
"externalCode": "223ddxzv223",
"archived": false,
"pathName": "",
"address": "г Уфа ул Жукова 19",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "3a85cfe3-12c5-11e6-9464-e4de00000087",
"name": "Площадь",
"type": "long",
"value": 4000
}
]
}
Массовое создание и обновление Складов
Массовое создание и обновление Складов. В теле запроса нужно передать массив, содержащий JSON представления Складов, которые вы хотите создать или обновить. Обновляемые Склады должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Складов
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/store"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"address": "г Москва ул Вавилова 19 к 116",
"pathName": "Основной склад",
"name": "Склад2",
"code": "code3",
"externalCode": "sfksjafwuiw1sf32141"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/0c8de58c-056c-11e6-9464-e4de00000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"address": "г Москва ул БаБилова 20 к 116",
"pathName": "Не Основной склад",
"name": "Склад3",
"code": "code31",
"externalCode": "EXTCODE",
"parent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Складов.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/0c8de58c-056c-11e6-9464-e4de00000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "0c8de58c-056c-11e6-9464-e4de00000003",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 16:47:10",
"name": "Склад2",
"code": "code3",
"externalCode": "sfksjafwuiw1sf32141",
"archived": false,
"pathName": "",
"address": "г Москва ул Вавилова 19 к 116"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/0c8de58c-056c-11e6-9464-e4de00000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "0c8de58c-056c-11e6-9464-e4de00000003",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 16:56:31",
"name": "Склад3",
"code": "code31",
"externalCode": "EXTCODE",
"archived": false,
"pathName": "",
"address": "г Москва ул БаБилова 20 к 116"
}
]
Удалить Склад
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Склада. |
Запрос на удаление Склада с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/store/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Склада.
Метаданные Складов
Метаданные Складов
Запрос на получение метаданных Складов. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Складов + attributes - Массив объектов доп. полей Складов в формате Метаданных + createShared - создавать новые Склады с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Складов
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/store/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Складов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
|Параметр |Описание |
|---|---|
|id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля.|
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/store/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
Склад
Получить Склад
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Склада. |
Запрос на получение отдельного Склада с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/store/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Склада с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/95dcda62-056b-11e6-9464-e4de000000b7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "95dcda62-056b-11e6-9464-e4de000000b7",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 16:43:51",
"name": "Склад1",
"description": "Основной склад",
"code": "113AB79",
"externalCode": "fQPIOtxjg-FaeZNKcLx6B3",
"archived": false,
"parent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"pathName": "Основной склад",
"address": "МО Одинцово ул Ленина д51 к 39",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "3a85cfe3-12c5-11e6-9464-e4de00000087",
"name": "Площадь",
"type": "long",
"value": 4400
}
]
}
Изменить Склад
Описание
Обновляется представление Склада с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Склада,
кроме полей, помеченных Только для чтения в описании атрибутов Склада.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Склада. |
Пример запроса на обновление существующего Склада.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/store/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"address": "г Москва ул БаБилова 20 к 116",
"pathName": "Не Основной склад",
"name": "Склад3",
"code": "code31",
"externalCode": "EXTCODE",
"parent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Склада.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/0c8de58c-056c-11e6-9464-e4de00000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "0c8de58c-056c-11e6-9464-e4de00000003",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 16:56:31",
"name": "Склад3",
"code": "code31",
"externalCode": "EXTCODE",
"archived": false,
"pathName": "",
"address": "г Москва ул БаБилова 20 к 116"
}
Пример запроса на обновление существующего Склада с доп полями в теле запроса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/store/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"address": "г Уфа ул Жукова 19/27",
"pathName": "Основной склад",
"name": "Склад 3",
"code": "code4",
"externalCode": "223ddxzv223",
"attributes": [
{
"id": "3a85cfe3-12c5-11e6-9464-e4de00000087",
"value": 4400
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Склада.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/7a6a11b6-12c5-11e6-9464-e4de00000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"id": "7a6a11b6-12c5-11e6-9464-e4de00000006",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-05 16:32:02",
"name": "Склад 3",
"code": "code4",
"externalCode": "223ddxzv223",
"archived": false,
"pathName": "",
"address": "г Уфа ул Жукова 19/27",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "3a85cfe3-12c5-11e6-9464-e4de00000087",
"name": "Площадь",
"type": "long",
"value": 4400
}
]
}
Юрлицо
Средствами JSON API можно создавать и обновлять сведения о юрлицах, запрашивать списки юрлиц и сведения по отдельным юрлицам. С помощью специального ресурса можно управлять счетами отдельного юрлица. Кодом сущности для юрлица в составе JSON API является ключевое слово organization.
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке.
Поиск среди объектов юрлиц на соответствие поисковой строке будет осуществлён по следующим полям: + По наименованию Юрлица name + По коду Юрлица code + По полному наименованию Юрлица legalTitle + По адресу электронной почты email + По номеру городского телефона phone + По номеру дисконтной карты
Юрлица
- meta - Метаданные о юрлице
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- updated - Момент последнего обновления сущности
Только для чтения - name - Краткое наименование юрлица
Необходимое - description - Комментарий к Юр. лицу
- code - Код юрлица
- externalCode - Внешний код юрлица
- archived - Добавлено ли юрлицо в архив
- created - Дата создания
- companyType - Тип юрлица.
[Юридическое лицо, Индивидуальный предприниматель, Физическое лицо]. В зависимости от значения данного поля набор выводимых реквизитов юрлица может меняться. Подробнее тут
Поля реквизитов
- legalTitle - Полное наименование юрлица
- legalAddress - Юридический адрес юрлица
- inn - ИНН
- kpp - КПП
- ogrn - ОГРН
- ogrnip - ОГРНИП
- okpo - ОКПО
- certificateNumber - Номер свидетельства
- certificateDate - Дата свидетельства ___
- email - Электронная почта
- phone - Телефон
- fax - Факс
- accounts - Метаданные, представляющие собой ссылку на счета юрлица
- attributes - Коллекция доп. полей в формате Метаданных
- isEgaisEnable - Включен ли ЕГАИС для данного юрлица
- fsrarId - Идентификатор в ФСРАР
- payerVat - Является ли данное юрлицо плательщиком НДС
- utmUrl - IP-адрес УТМ
- actualAddress - Фактический адрес юрлица
- director - Руководитель
- chiefAccountant - Главный бухгалтер
Атрибуты вложенных сущностей
Счета юрлица
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - Момент последнего обновления сущности
Только для чтения - isDefault - Является ли счёт основным счётом юрлица
- accountNumber - Номер счёта
Необходимо - bankName - Наименование банка
- bankLocation - Адрес банка
- correspondentAccount - Корр счет
- bic - БИК
- agent - Ссылка на юрлицо (тип Мета)
Необходимо
Тип юрлица
В зависимости от типа юрлица companyType в составе его объекта будут выводиться разные наборы реквизитов. Типы юрлица и соответствующие значения, которые могут быть переданы в значение данного поля: | Тип юрлица | Значение поля companyType | | ------------------------------ |:---------------------------| | Юридическое лицо | legal | | Индивидуальный предприниматель | entrepreneur | | Физическое лицо | individual |
Если тип юрлица Юридическое лицо, будут выведены следующие поля реквизитов:
+ legalTitle - Полное наименование юрлица
+ legalAddress - Юридический адрес юрлица
+ inn - ИНН
+ kpp - КПП
+ ogrn - ОГРН
+ okpo - ОКПО
Если тип юрлица Индивидуальный предприниматель, будут выведены следующие поля реквизитов:
+ legalTitle - Полное наименование юрлица
+ legalAddress - Юридический адрес юрлица
+ inn - ИНН
+ okpo - ОКПО
+ ogrnip - ОГРНИП
+ certificateNumber - Номер свидетельства
+ certificateDate - Дата свидетельства
Если тип юрлица Физическое лицо, будут выведены следующие поля реквизитов:
+ legalTitle - Полное наименование юрлица
+ legalAddress - Юридический адрес юрлица
+ inn - ИНН
О работе с доп. полями юрлиц можно прочитать здесь
Получить список юрлиц
Запрос на получение списка юрлиц на данной учётной записи. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой юрлица.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить список юрлиц
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/organization"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос.Результат: Объект JSON, включающий в себя поля:
{
"context": {
"employee": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
},
"id": "850c8195-f504-11e5-8a84-bae50000015e",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 17:26:20",
"name": "ООО ОАО ООО ОАО",
"description": "юрлицо, делающее основнуб прибыль",
"code": "1214124",
"externalCode": "6IRv89VSgKY7yQAmAuV7n0",
"archived": false,
"created": "2007-02-07 17:16:41",
"legalTitle": "ООО Великое объединение любителей великих объединений",
"legalAddress": "г Москва ул Улица д дом/корпус",
"actualAddress": "Ул Вавилова д 75",
"inn": "8274424278",
"kpp": "123456789",
"ogrn": "121410924",
"okpo": "1241252156",
"email": "asdad@sfasf.erq",
"phone": "fawofyho21f1",
"fax": "feisafhn0e12f31",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "account",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"isEgaisEnable": true,
"fsrarId": "1963703",
"payerVat": true,
"utmUrl": "10.250.110.81"
}
]
}
Создать юрлицо
Запрос на создание нового юрлица.
Описание
Юрлицо создаётся на основе переданного объекта JSON, который содержит представление нового юрлица.
Пример создания нового юрлица.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/organization"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Пермь ул Сталина д 75",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"isEgaisEnable": true,
"fsrarId": "1963703",
"payerVat": true,
"utmUrl": "10.250.110.81",
"director": "Кипелова Александра",
"chiefAccountant": "Подкупников Иван"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного юрлица.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
},
"id": "4b9d5bec-0575-11e6-9464-e4de00000008",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 17:53:21",
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Пермь ул Сталина д 75",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008/accounts",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "account",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"isEgaisEnable": true,
"fsrarId": "1963703",
"payerVat": true,
"utmUrl": "10.250.110.81"
}
Пример создания нового юрлица с доп полями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/organization"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Пермь ул Сталина д 75",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"attributes": [
{
"id": "7f4a6b38-12bb-11e6-9464-e4de00000076",
"value": "Строковое значение"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного юрлица.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/bf182d24-12d7-11e6-9464-e4de00000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
},
"id": "bf182d24-12d7-11e6-9464-e4de00000012",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-05 18:40:51",
"name": "ОАО СветГАЗКАМАЗПром",
"description": "Новое юрлицо",
"code": "666",
"externalCode": "sfwafn22-124124sa",
"archived": false,
"created": "2007-02-07 17:16:41",
"legalTitle": "ООО Великое Сообщество КАМАЗ ПРОМ",
"legalAddress": "г Москва ул Ленина д 42/685",
"actualAddress": "г Пермь ул Глумилина д 75",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetpromgazkamaz@mail.svet",
"phone": "22222222",
"fax": "belwo123",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "7f4a6b38-12bb-11e6-9464-e4de00000076",
"name": "Строковое поле",
"type": "string",
"value": "Строковое значение"
}
],
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/bf182d24-12d7-11e6-9464-e4de00000012/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
Массовое создание и обновление юрлиц
Массовое создание и обновление юрлиц. В теле запроса нужно передать массив, содержащий JSON представления юрлиц, которые вы хотите создать или обновить. Обновляемые юрлица должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких юрлиц
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/organization"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Пермь ул Сталина д 75",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"isEgaisEnable": true,
"fsrarId": "1963703",
"payerVat": true,
"utmUrl": "10.250.110.81",
"director": "Кипелова Александра",
"chiefAccountant": "Подкупников Иван"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/bf182d24-12d7-11e6-9464-e4de00000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
},
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Уфа ул Маяковского д 65",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"payerVat": false,
"director": "Вздрыжженов Иван Валерьевич",
"chiefAccountant": "Кулумбекова Василиса Иисмаиловна"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных юрлиц.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
},
"id": "4b9d5bec-0575-11e6-9464-e4de00000008",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 17:53:21",
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Пермь ул Сталина д 75",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008/accounts",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "account",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"isEgaisEnable": true,
"fsrarId": "1963703",
"payerVat": true,
"utmUrl": "10.250.110.81"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/bf182d24-12d7-11e6-9464-e4de00000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
},
"id": "bf182d24-12d7-11e6-9464-e4de00000012",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-05 18:40:51",
"name": "ОАО СветГАЗКАМАЗПром",
"description": "Новое юрлицо",
"code": "666",
"externalCode": "sfwafn22-124124sa",
"archived": false,
"created": "2007-02-07 17:16:41",
"legalTitle": "ООО Великое Сообщество КАМАЗ ПРОМ",
"legalAddress": "г Москва ул Ленина д 42/685",
"actualAddress": "г Уфа ул Маяковского д 65",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetpromgazkamaz@mail.svet",
"phone": "22222222",
"fax": "belwo123",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/bf182d24-12d7-11e6-9464-e4de00000012/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payerVat": false,
"director": "Вздрыжженов Иван Валерьевич",
"chiefAccountant": "Кулумбекова Василиса Иисмаиловна"
}
]
Удалить юрлицо
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id юрлица. |
Запрос на удаление юрлица с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/organization/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление юрлица.
Метаданные юрлиц
Запрос на получение метаданных юрлиц. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные юрлиц + attributes - Массив объектов доп. полей юрлиц в формате Метаданных + createShared - создавать новые юрлица с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные юрлиц
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей юрлиц.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
],
"createShared": true
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
Юрлицо
Получить юрлицо
Запрос на получение юрлица с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id юрлица. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить юрлицо
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/organization/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление нового юрлица.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
},
"id": "4b9d5bec-0575-11e6-9464-e4de00000008",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 17:57:27",
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"created": "2007-02-07 17:16:41",
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Пермь ул Сталина д 75",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"ogrnip": "58632598y21jk",
"certificateNumber": "klghvew983412",
"certificateDate": "2016-04-30 00:00:00",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008/accounts",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "account",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"isEgaisEnable": true,
"fsrarId": "1963703",
"payerVat": true,
"utmUrl": "10.250.110.81",
"director": "Администратор",
"chiefAccountant": "Администратор"
}
Изменить юрлицо
Запрос на обновление юрлица с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id юрлица. |
Пример запроса на обновление юрлица с указанным id.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/organization/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Пермь ул Сталина д 75",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"isEgaisEnable": true,
"fsrarId": "1963703",
"payerVat": true,
"utmUrl": "10.250.110.81",
"director": "Кипелова Александра",
"chiefAccountant": "Подкупников Иван"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON обновлённого юрлица.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
},
"id": "4b9d5bec-0575-11e6-9464-e4de00000008",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-04-18 17:53:21",
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Пермь ул Сталина д 75",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008/accounts",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "account",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"isEgaisEnable": true,
"fsrarId": "1963703",
"payerVat": true,
"utmUrl": "10.250.110.81"
}
Пример запроса на обновление юрлица с указанным id.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/organization/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "ОАО СветПром",
"description": "юрлицо, делающее маленькую прибыль",
"code": "666",
"externalCode": "666АААА666",
"archived": false,
"legalTitle": "ООО Великое Свет Пром",
"legalAddress": "г Москва ул Ленин д 42/685",
"actualAddress": "г Уфа ул Маяковского д 65",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetprom@mail.svet",
"phone": "22222222",
"fax": "bello123",
"attributes": [
{
"id": "7f4a6b38-12bb-11e6-9464-e4de00000076",
"value": "Такая Строка"
}
],
"payerVat": false,
"director": "Вздрыжженов Иван Валерьевич",
"chiefAccountant": "Кулумбекова Василиса Иисмаиловна"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON обновлённого юрлица.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/bf182d24-12d7-11e6-9464-e4de00000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
},
"id": "bf182d24-12d7-11e6-9464-e4de00000012",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-05 18:40:51",
"name": "ОАО СветГАЗКАМАЗПром",
"description": "Новое юрлицо",
"code": "666",
"externalCode": "sfwafn22-124124sa",
"archived": false,
"created": "2007-02-07 17:16:41",
"legalTitle": "ООО Великое Сообщество КАМАЗ ПРОМ",
"legalAddress": "г Москва ул Ленина д 42/685",
"actualAddress": "г Уфа ул Маяковского д 65",
"inn": "87654321",
"kpp": "15312532",
"ogrn": "12345",
"okpo": "12345",
"email": "svetpromgazkamaz@mail.svet",
"phone": "22222222",
"fax": "belwo123",
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "7f4a6b38-12bb-11e6-9464-e4de00000076",
"name": "Строковое поле",
"type": "string",
"value": "Строковое значение"
}
],
"accounts": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/bf182d24-12d7-11e6-9464-e4de00000012/accounts",
"type": "account",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payerVat": false,
"director": "Вздрыжженов Иван Валерьевич",
"chiefAccountant": "Кулумбекова Василиса Иисмаиловна"
}
Счета юрлица
Получить список счетов юрлица
Возвращает массив JSON представлений счетов юрлица.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id юрлица. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить список счетов юрлица
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/organization/7944ef04-f831-11e5-7a69-971500188b19/accounts"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос.
{
"context": {
"employee": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008/accounts",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "account",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008/accounts/4b9d69b7-0575-11e6-9464-e4de00000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "account",
"mediaType": "application/json"
},
"id": "4b9d69b7-0575-11e6-9464-e4de00000009",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-18 17:53:21",
"isDefault": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/4b9d5bec-0575-11e6-9464-e4de00000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}
]
}
Изменить счета юрлица
Описание
Обновляются счета юрлица с указанным id.
Обновляются все поля, указанные в JSON объекте запроса, кроме
помеченных Только для чтения в описании атрибутов счетов юрлица.
Поля, которые не были указаны в JSON запроса, не изменяются.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id юрлица. |
Изменить счета юрлица
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/organization/7944ef04-f831-11e5-7a69-971500188b19/accounts"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/d955aa70-6703-11e7-9464-e4de00000051/accounts/d9560d0e-6703-11e7-9464-e4de00000052",
"type": "account",
"mediaType": "application/json"
},
"id": "d9560d0e-6703-11e7-9464-e4de00000052",
"isDefault": false,
"accountNumber": "1234567876543",
"bankName": "\"ОАО Сбербm;анк\"",
"bankLocation": "г Моl;;lсква",
"correspondentAccount": "12314124jkjj2451",
"bic": "21412hhhh4"
},
{
"isDefault": false,
"accountNumber": "1234567876543",
"bankName": "\"ОАО БАНК\"",
"bankLocation": "г Москва",
"correspondentAccount": "12314124jkjj2451",
"bic": "21412555554"
}
]'
Response 200 (application/json) Успешный запрос.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/d955aa70-6703-11e7-9464-e4de00000051/accounts/d9560d0e-6703-11e7-9464-e4de00000052",
"type": "account",
"mediaType": "application/json"
},
"id": "d9560d0e-6703-11e7-9464-e4de00000052",
"accountId": "d8a2e973-6703-11e7-9464-e4de00000001",
"updated": "2017-07-12 16:13:08",
"isDefault": true,
"accountNumber": "1234567876543",
"bankName": "\"ОАО Сбербm;анк\"",
"bankLocation": "г Моl;;lсква",
"correspondentAccount": "12314124jkjj2451",
"bic": "21412hhhh4"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/d955aa70-6703-11e7-9464-e4de00000051/accounts/97fc6499-b96f-11e7-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
},
"id": "97fc6499-b96f-11e7-9464-e4de00000006",
"accountId": "d8a2e973-6703-11e7-9464-e4de00000001",
"updated": "2017-10-25 13:31:00",
"isDefault": false,
"accountNumber": "1234567876543",
"bankName": "\"ОАО БАНК\"",
"bankLocation": "г Москва",
"correspondentAccount": "12314124jkjj2451",
"bic": "21412555554"
}
]
Точка продаж
Точки продаж
Средствами JSON API можно запрашивать списки Точек продаж и сведения по отдельным точкам продаж. Также можно получить доступ к специальному ресурсу для управления кассирами точки продаж. Кодом сущности для точки продаж в составе JSON API является ключевое слово retailstore. Больше о точках продаж и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке в разделе "Создание точки продаж в основном интерфейсе".
По данной сущности можно осуществлять контекстный поиск с помощью специального параметра search. Подробнее можно узнать по ссылке. Поиск с параметром search отличается от других тем, что поиск не префиксный, без токенизации и идет только по одному полю одновременно. Ищет такие строки, в которые входит значение строки поиска.
Поиск среди объектов точек продаж на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию Точки продаж name + по адресу Точки продаж address
Атрибуты сущности
- meta - Метаданные о смене
Только для чтения - id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
Только для чтения - shared - Общий доступ
Только для чтения - group - Отдел сотрудника в формате Метаданных
Только для чтения - updated - Момент последнего обновления сущности
Только для чтения - name - Наименование точки продаж
Только для чтения - description - Описание точки продаж
Только для чтения - externalCode - Внешний код точки продаж
Только для чтения - archived - Добавлена ли точка продаж в архив
Только для чтения - address - Адрес
Только для чтения - controlShippingStock - Контроль остатков
Только для чтения - onlyInStock - Выгружать только товары в наличии. Доступно только при активном контроле остатков. Влияет только на выгрузку остатков в POS API
Только для чтения - active - Включена
Только для чтения - controlCashierChoice - Выбор продавца
Только для чтения - discountEnable - Разрешить скидки
- discountMaxPercent - Максимальная скидка (в процентах)
- priceType - Тип цен, с которыми будут продаваться товары в рознице
Только для чтения - cashiers - Ссылка на Кассиров в формате Метаданных
Только для чтения - egaisEnabled - Точка продаж должна передавать данные в ЕГАИС
- frNumber - Номер модели ФР
- organization - Ссылка на ваше юрлицо в формате Метаданных
Только для чтения - store - Ссылка на склад в формате Метаданных
Только для чтения - acquire - Банк-эквайер
Только для чтения - issueOrders - Выдача заказов
Только для чтения - sellReserves - Учет резервов
Только для чтения - lastOperationNames - Последние операции
Только для чтения - ofdEnabled - Отправлять электронный чек через ОФД
- allowCustomPrice - Разрешить продажу по свободной цене
- authTokenAttached - создан ли токен для точки продаж
Только для чтения - orderToState - Ссылка на статус, который проставится заказу после проведения продажи на его основании (если указано), в формате Метаданных
Только для чтения - customerOrderStates - Ссылка на статусы, в которых выгружаются заказы в точку продаж (если указано), в формате Метаданных
Только для чтения - environment - информация об окружении
- state - информация о статусе точки продаж
Аттрибуты сущности Окружение
- device - информация об устройстве
- os - информация об операционной системе
- software - информация о ПО
- chequePrinter - данные о ККТ
- paymentTerminal - информация о платежном терминале ###### Аттрибуты сущности ПО
- name - наименование ПО.
Необходимое - vendor - Производитель.
- version - версия ПО. ###### Аттрибуты сущности ККТ
- vendor - Производитель
- name - Наименование.
Необходимое - serial - серийный номер
- fiscalDataVersion - формат фискальных данных
- driver - информация об используемом драйвере
- fiscalMemory - информация о фискальном накопителе
- firmwareVersion - Версия прошивки ККТ ###### Аттрибуты сущности Драйвер
- name - наименования драйвера
- version - Версия драйвера ###### Аттрибуты сущности Фискальный накопитель
- fiscalDataVersion - версия фискальной памяти
Аттрибуты сущности Статус
- sync - состояние синхронизации
- lastCheckMoment - дата и время последней синхронизации
- fiscalMemory - информация о фискальной памяти
- paymentTerminal - информация о платежном терминале
Deprecated
Аттрибуты сущности Синхронизация
- message - состояние синхронизации.
- lastAttempMoment - Дата последней сихронизации (не обязательно успешной).
Необходимое###### Аттрибуты сущности Фискальная Память - error - информация об ошибке ФН
- notSendDocCount - Количество неотправленных документов в ОФД
- notSendFirstDocMoment - Дата первого документа в очереди на отправку ###### Аттрибуты сущности Ошибка
- сode - код ошибки ФН
- message - описание ошибки ###### Аттрибуты сущности Платежный Терминал
- acquiringType - информация о типе эквайера (например: inpas/payme)
Последние операции
Поле lastOperationNames представляет собой массив объектов со следующей структурой:
- entity - Ключевое слово, обозначающее тип последней операции
Только для чтения - name - Наименование (номер) последней операции
Только для чтения
Представляет собой краткий список последних операций на данной точке продаж. Если продаж на данной точке по факту нет, то номера продаж будут фейковые
Кассиры
Сущность кассир представляет собой объект, содержащий ссылки на Сотрудника, назначенного кассиром, и Точку продаж, к которой он привязан. Подробнее о сущности Кассира можно посмотреть в разделе Кассиры
Атрибуты сущности Кассир
- meta - Метаданные о смене
Только для чтения - id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - employee - Ссылка на сотрудника в формате Метаданных
Только для чтения - retailStore - Ссылка на точку продаже в формате Метаданных
Только для чтения
Получить точки продаж
Запрос всех Розничных точек продаж на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Розничные точки продаж.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить точки продаж
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailstore"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Розничных точек продаж.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/2b5eb22f-139e-11e6-9464-e4de00000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
},
"id": "2b5eb22f-139e-11e6-9464-e4de00000073",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-06 18:21:13",
"name": "Точка2",
"description": "вторая точка",
"externalCode": "Et9M3cprgDiJPi7llDOhX0",
"controlShippingStock": false,
"active": true,
"controlCashierChoice": false,
"discountEnable": true,
"discountMaxPercent": 17,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
},
"authTokenAttached": false,
"cashiers": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/2b5eb22f-139e-11e6-9464-e4de00000073/cashiers",
"type": "cashier",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"egaisEnabled": true,
"frNumber": "134578",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"issueOrders": false,
"sellReserves": false,
"lastOperationNames": [
{
"entity": "retaildemand",
"name": "00002"
}
],
"ofdEnabled": false,
"allowCustomPrice": false,
"environment": {
"device": "Some device name",
"os": "Linux",
"software": {
"name": "Касса МойСклад",
"vendor": "МойСклад",
"version": "2.2"
},
"chequePrinter": {
"vendor": "АТОЛ",
"name": "30Ф",
"serial": "123456",
"fiscalDataVersion": "1.0",
"driver": {
"name": "АТОЛ (бета)",
"version": "9.1"
},
"fiscalMemory": {
"fiscalDataVersion": "1.0"
},
"firmwareVersion": "669"
},
"paymentTerminal": {
"acquiringType": "payme"
}
},
"state": {
"sync": {
"message": "Ошибка синхронизации, необходимо войти повторно",
"lastAttempMoment": "2016-09-06 21:41:00"
},
"lastCheckMoment": "2018-02-05 15:58:24",
"fiscalMemory": {
"error": {
"code": "1003",
"message": "Критическая ошибка"
},
"notSendDocCount": 25,
"notSendFirstDocMoment": "2016-09-06 21:41:00"
},
"paymentTerminal": {
"acquiringType": "payme"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
},
"id": "31b6349e-137a-11e6-9464-e4de0000005d",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-06 18:09:54",
"name": "Точка продаж",
"externalCode": "AEhB1gX7inNaXzAGSbDeh0",
"controlShippingStock": true,
"onlyInStock": false,
"active": true,
"controlCashierChoice": false,
"discountEnable": false,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
},
"authTokenAttached": false,
"cashiers": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d/cashiers",
"type": "cashier",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"egaisEnabled": true,
"frNumber": "134578",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"acquire": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/30fe66fd-137a-11e6-9464-e4de00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"issueOrders": false,
"sellReserves": false,
"lastOperationNames": [
{
"entity": "retaildemand",
"name": "00002"
}
],
"ofdEnabled": false,
"allowCustomPrice": false,
"environment": {
"device": "Some device name",
"os": "Linux",
"software": {
"name": "Касса МойСклад",
"vendor": "МойСклад",
"version": "2.2"
},
"chequePrinter": {
"vendor": "АТОЛ",
"name": "30Ф",
"serial": "123456",
"fiscalDataVersion": "1.0",
"driver": {
"name": "АТОЛ (бета)",
"version": "9.1"
},
"fiscalMemory": {
"fiscalDataVersion": "1.0"
},
"firmwareVersion": "669"
},
"paymentTerminal": {
"acquiringType": "payme"
}
},
"state": {
"sync": {
"message": "Ошибка синхронизации, необходимо войти повторно",
"lastAttempMoment": "2016-09-06 21:41:00"
},
"lastCheckMoment": "2018-02-05 15:58:24",
"fiscalMemory": {
"error": {
"code": "1003",
"message": "Критическая ошибка"
},
"notSendDocCount": 25,
"notSendFirstDocMoment": "2016-09-06 21:41:00"
},
"paymentTerminal": {
"acquiringType": "payme"
}
}
}
]
}
Удалить точку продаж
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Точки продаж. |
Запрос на удаление Розничной точки продаж с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/retailstore/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Розничной точки продаж.
Точка продаж
Получить точку продаж
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Точки продаж. |
Запрос на получение отдельной Розничной точки продаж с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailstore/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление точки продаж.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
},
"id": "31b6349e-137a-11e6-9464-e4de0000005d",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-05-06 18:09:54",
"name": "Точка продаж",
"externalCode": "AEhB1gX7inNaXzAGSbDeh0",
"controlShippingStock": true,
"onlyInStock": true,
"active": true,
"controlCashierChoice": false,
"discountEnable": true,
"discountMaxPercent": 17,
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
},
"authTokenAttached": false,
"cashiers": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d/cashiers",
"type": "cashier",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"egaisEnabled": true,
"frNumber": "134578",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"acquire": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/30fe66fd-137a-11e6-9464-e4de00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"issueOrders": false,
"sellReserves": false,
"lastOperationNames": [
{
"entity": "retaildemand",
"name": "00002"
}
],
"ofdEnabled": false,
"allowCustomPrice": false,
"environment": {
"device": "Some device name",
"os": "Linux",
"software": {
"name": "Касса МойСклад",
"vendor": "МойСклад",
"version": "2.2"
},
"chequePrinter": {
"vendor": "АТОЛ",
"name": "30Ф",
"serial": "15636313",
"fiscalDataVersion": "1.0",
"driver": {
"name": "АТОЛ (бета)",
"version": "9.1"
},
"fiscalMemory": {
"fiscalDataVersion": "1.0"
},
"firmwareVersion": "669"
},
"paymentTerminal": {
"acquiringType": "payme"
}
},
"state": {
"sync": {
"message": "Ошибка синхронизации, необходимо войти повторно",
"lastAttempMoment": "2016-09-06 21:41:00"
},
"lastCheckMoment": "2018-02-05 15:58:24",
"fiscalMemory": {
"error": {
"code": "1003",
"message": "Критическая ошибка"
},
"notSendDocCount": 25,
"notSendFirstDocMoment": "2016-09-06 21:41:00"
},
"paymentTerminal": {
"acquiringType": "payme"
}
}
}
Кассир
Кассиры
Средствами JSON API можно запрашивать списки Кассиров и сведения по отдельным кассирам. Кодом сущности для кассира в составе JSON API является ключевое слово cashier.
Атрибуты сущности
- meta - Метаданные о смене
Только для чтения - id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - employee - Ссылка на сотрудника в формате Метаданных
- retailStore - Ссылка на точку продаже в формате Метаданных
Получить Кассиров
Запрос на получение списка всех кассиров на данной точке продаж. Результат: Объект JSON, включающий в себя поля: - context - Метаданные о сотруднике, выполнившем запрос. - meta Метаданные о выдаче. - rows - Массив JSON объектов, представляющих собой кассиров.
Параметры
| Параметр | Описание |
|---|---|
| retailStoreId | string (required) Example: ea05e0c9-8667-11e7-8a7f-40d000000060 id Точки продаж. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Кассиров
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailstore/ea05e0c9-8667-11e7-8a7f-40d000000060/cashiers"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка кассиров.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/ea05e0c9-8667-11e7-8a7f-40d000000060/cashiers",
"type": "cashier",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/ea05e0c9-8667-11e7-8a7f-40d000000060/cashiers/3902eb20-139f-11e6-9464-e4de00000077",
"type": "cashier",
"mediaType": "application/json"
},
"id": "3902eb20-139f-11e6-9464-e4de00000077",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/30c1cfcc-137a-11e6-9464-e4de00000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=30c1cfcc-137a-11e6-9464-e4de00000028"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/ea05e0c9-8667-11e7-8a7f-40d000000060",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#retailstore/edit?id=ea05e0c9-8667-11e7-8a7f-40d000000060"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/ea05e0c9-8667-11e7-8a7f-40d000000060/cashiers/6674fde7-139f-11e6-9464-e4de0000007e",
"type": "cashier",
"mediaType": "application/json"
},
"id": "6674fde7-139f-11e6-9464-e4de0000007e",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/5bd62f8f-139f-11e6-9464-e4de0000007b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=5bd62f8f-139f-11e6-9464-e4de0000007b"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/ea05e0c9-8667-11e7-8a7f-40d000000060",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#retailstore/edit?id=ea05e0c9-8667-11e7-8a7f-40d000000060"
}
}
}
]
}
Кассир
Получить Кассира
Параметры
| Параметр | Описание |
|---|---|
| retailStoreId | string (required) Example: ea05e0c9-8667-11e7-8a7f-40d000000060 id Точки продаж. |
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Кассира. |
Запрос на получение отдельного кассира с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailstore/ea05e0c9-8667-11e7-8a7f-40d000000060/cashiers/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного кассира.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/ea05e0c9-8667-11e7-8a7f-40d000000060/cashiers/3902eb20-139f-11e6-9464-e4de00000077",
"type": "cashier",
"mediaType": "application/json"
},
"id": "3902eb20-139f-11e6-9464-e4de00000077",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/30c1cfcc-137a-11e6-9464-e4de00000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=30c1cfcc-137a-11e6-9464-e4de00000028"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/ea05e0c9-8667-11e7-8a7f-40d000000060",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#retailstore/edit?id=ea05e0c9-8667-11e7-8a7f-40d000000060"
}
}
}
Веб-хуки
На платных аккаунтах с помощью средств JSON API вы можете: получать, создавать, обновлять, отключать и удалять веб-хуки. Управление веб-хуками доступно только администратору аккаунта. Ключевым словом для веб-хуков в рамках JSON api является webhook.
Веб-хуки
Пример того, в каком виде будут передаваться данные:
{
"events":
[
{"meta":
{
"type":"product",
"href":"https://online.moysklad.ru/api/remap/1.2/entity/product/c1557cfb-c2cc-11e6-7a31-d0fd000f0b00"
},
"action":"DELETE"
}
]
}
В массиве events может быть несколько объектов.
В ответ на наш запрос мы ожидаем получить ответ с HTTP статусом 200 или 204.
С помощью API версии 1.2 можно просматривать, изменять, удалять веб-хуки созданные только с помощью API версии 1.2.
Заголовок временного отключения через API
Через JSON API или POS API при запросах можно отключить уведомления вебхуков в контексте данного запроса. Для этого нужно указать заголовок X-Lognex-WebHook-Disable с произвольным значением.
Атрибуты сущности
- meta - Метаданные веб-хука
- id - id веб-хука
- accountId - id учётной записи
- entityType - тип сущности, к которой привязан веб-хук
Необходимое - url - URL, по которому будет происходить запрос
Необходимое - method - HTTP метод, с которым будет происходить запрос
Возможные значения:POST - enabled - Флажок состояние веб-хука (включен / отключен)
- action - Действие, которое отслеживается веб-хуком
Необходимое
Возможные значения: ``
Получить список веб-хуков
Запрос на получение всех веб-хуков на данной учётной записи.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/webhook"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка веб-хуков.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/aec51463-bbd2-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"id": "aec51463-bbd2-11e6-8a84-bae500000003",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"entityType": "demand",
"url": "http://www.example.com",
"method": "POST",
"enabled": true,
"action": "CREATE"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/d08f9217-bbd2-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"id": "d08f9217-bbd2-11e6-8a84-bae500000004",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"entityType": "supply",
"url": "http://www.example.com",
"method": "POST",
"enabled": true,
"action": "CREATE"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/d946c7ff-bbd2-11e6-8a84-bae500000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"id": "d946c7ff-bbd2-11e6-8a84-bae500000005",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"entityType": "cashin",
"url": "http://www.example.com",
"method": "POST",
"enabled": true,
"action": "UPDATE"
}
]
}
Создать веб-хук
Пример запроса на создание нового веб-хука. Убедитесь, что создаетё ещё не существующий веб-хук: сочетание entityType, action должно быть уникальным.
Пример запроса на создание нового веб-хука.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/webhook"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"url": "http://www.example.com",
"action": "CREATE",
"entityType": "supply"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного веб-хука.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/d08f9217-bbd2-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"id": "d08f9217-bbd2-11e6-8a84-bae500000004",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"entityType": "supply",
"url": "http://www.example.com",
"method": "POST",
"enabled": true,
"action": "CREATE"
}
Веб-хук
Массовое создание и обновление веб-хуков
Массовое создание и обновление веб-хуков. В теле запроса нужно передать массив, содержащий JSON представления веб-хуков, которые вы хотите создать или обновить. Обновляемые веб-хуки должны содержать идентификатор в виде метаданных.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id веб-хука. |
Пример создания и обновления нескольких веб-хуков
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/webhook/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"url": "http://www.example.com",
"action": "CREATE",
"entityType": "supply"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/aec51463-bbd2-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"url": "http://www.example.com",
"action": "DELETE"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных веб-хуков.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/d08f9217-bbd2-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"id": "d08f9217-bbd2-11e6-8a84-bae500000004",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"entityType": "supply",
"url": "http://www.example.com",
"method": "POST",
"enabled": true,
"action": "CREATE"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/aec51463-bbd2-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"id": "aec51463-bbd2-11e6-8a84-bae500000003",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"entityType": "demand",
"url": "http://www.example.com",
"method": "POST",
"enabled": true,
"action": "DELETE"
}
]
Получить отдельный веб-хук
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id веб-хука. |
Запрос на получение отдельного веб-хука с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/webhook/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление веб-хука с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/aec51463-bbd2-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"id": "aec51463-bbd2-11e6-8a84-bae500000003",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"entityType": "demand",
"url": "http://www.example.com",
"method": "POST",
"enabled": true,
"action": "CREATE"
}
Обновить веб-хук
Пример запроса на обновление сведений о веб-хуке.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id веб-хука. |
Пример запроса на обновление веб-хука.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/webhook/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"url": "http://www.example.com",
"action": "DELETE"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого веб-хука.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/aec51463-bbd2-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"id": "aec51463-bbd2-11e6-8a84-bae500000003",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"entityType": "demand",
"url": "http://www.example.com",
"method": "POST",
"enabled": true,
"action": "DELETE"
}
Отключить веб-хук
Пример запроса на отключение веб-хука.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id веб-хука. |
Пример запроса на отключение веб-хука.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/webhook/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"enabled": false
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление отключенного веб-хука.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/aec51463-bbd2-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/webhook/metadata",
"type": "webhook",
"mediaType": "application/json"
},
"id": "aec51463-bbd2-11e6-8a84-bae500000003",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"entityType": "demand",
"url": "http://www.example.com",
"method": "POST",
"enabled": false,
"action": "DELETE"
}
Удалить веб-хук
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id веб-хука. |
Пример запроса на удаление веб-хука с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/webhook/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление веб-хука.
Шаблон печатной формы
Средствами JSON API можно запрашивать списки шаблонов печатных форм для сущностей. Кодом сущности для стандартных шаблонов в составе JSON API является ключевое слово embeddedtemplate, а для пользовательских customtemplate.
Стандартные шаблоны
Атрибуты сущности
- meta - Метаданные о стандартном шаблоне
- id - id шаблона
- name - наименование шаблона
- type - тип шаблона (entity - документ)
- content - ссылка на скачивание
Список стандартных шаблонов
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: demand тип сущности, для которой запрашиваются стандартные шаблоны. |
Запрос на получение информации о стандартных шаблонах печатных форм для указанного типа сущности.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка стандартных шаблонов для данного типа сущности.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "embeddedtemplate",
"mediaType": "application/json",
"size": 6,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/c2645cf0-43f0-3379-adff-99929da86d5e",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "c2645cf0-43f0-3379-adff-99929da86d5e",
"name": "Транспортная накладная",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/ttn.xls"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/c5d5e3f2-6541-3ae3-9b7c-5da3665ab33e",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "c5d5e3f2-6541-3ae3-9b7c-5da3665ab33e",
"name": "Расходная накладная",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/rashod.xls"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/8a5bdbc2-ddb6-34f1-b359-05219426b979",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "8a5bdbc2-ddb6-34f1-b359-05219426b979",
"name": "ТОРГ-12",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/tov_nakl.xls"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/18386557-0c3d-30bc-9b76-fe30c9893f84",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "18386557-0c3d-30bc-9b76-fe30c9893f84",
"name": "Товарный чек",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/demand_check.xls"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/1aaef672-69a5-3e35-a849-71c2cd338ac0",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "1aaef672-69a5-3e35-a849-71c2cd338ac0",
"name": "Акт",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/act.xls"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/4fdd996f-d2fd-4500-baf2-fea33b6db077",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "4fdd996f-d2fd-4500-baf2-fea33b6db077",
"name": "Универсальный передаточный документ (старый)",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/upd.xls"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/4fdd996f-d2fd-4500-baf2-fea33b6db078",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "4fdd996f-d2fd-4500-baf2-fea33b6db078",
"name": "Универсальный передаточный документ",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/upd_new.xls"
}
]
}
Отдельный стандартный шаблон
Отдельный стандартный шаблон
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: demand тип сущности, для которой запрашиваются стандартные шаблоны. |
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id отдельного шаблона. |
Запрос на получение информации об отдельном стандартном шаблоне печатной формы для указанного типа сущности по его id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление стандартного шаблона для данного типа сущности.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/embeddedtemplate/c2645cf0-43f0-3379-adff-99929da86d5e",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "c2645cf0-43f0-3379-adff-99929da86d5e",
"name": "Транспортная накладная",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/ttn.xls"
}
Стандартные шаблоны для ценников и этикеток
Атрибуты сущности
- meta - Метаданные о стандартном шаблоне
- id - id шаблона
- name - наименование шаблона
- type - тип шаблона (mxtemplate - новый тип шаблона для ценников и этикеток)
- content - ссылка на скачивание
Список стандартных ценников и этикеток
Запрос на получение информации о стандартных шаблонах печатных форм для товаров, модификаций, услуг и комплектов.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка стандартных шаблонов для товаров, модификаций, услуг и комплектов .
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate",
"type": "embeddedtemplate",
"mediaType": "application/json",
"size": 2,
"limit": 100,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate/a8218d14-6017-3ba4-85c4-254fff93bbc8",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "a8218d14-6017-3ba4-85c4-254fff93bbc8",
"name": "Термоэтикетка (58х40мм)",
"type": "mxtemplate",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/termo_58x40.xml"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate/2746190f-cf7c-3a0b-922d-e75f44e88cce",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "2746190f-cf7c-3a0b-922d-e75f44e88cce",
"name": "Ценник (70x49,5мм)",
"type": "mxtemplate",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/price_tag_70x49.5.xml"
}
]
}
Отдельный стандартный шаблон для ценников и этикеток
Отдельный стандартный ценник или этикетка
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id отдельного шаблона. |
Запрос на получение информации об отдельном стандартном шаблоне печатной формы для товаров, модификаций, услуг и комплектов по его id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление стандартного шаблона для товаров, модификаций, услуг и комплектов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate/a8218d14-6017-3ba4-85c4-254fff93bbc8",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "a8218d14-6017-3ba4-85c4-254fff93bbc8",
"name": "Термоэтикетка (58х40мм)",
"type": "mxtemplate",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/termo_58x40.xml"
}
Пользовательские шаблоны
Атрибуты сущности
- meta - Метаданные о пользовательском шаблоне
- id - id шаблона
- name - наименование шаблона
- type - тип шаблона (entity - документ)
- content - ссылка на скачивание
Список пользовательских шаблонов
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: customerorder тип сущности, для которой запрашиваются пользовательские шаблоны. |
Запрос на получение информации о пользовательских шаблонах печатных форм для указанного типа сущности.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/customtemplate/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка стандартных шаблонов для данного типа сущности.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/customtemplate/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customtemplate",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009",
"type": "customtemplate",
"mediaType": "application/json"
},
"id": "38d1c843-1601-11e7-8af5-581e00000009",
"name": "tratata",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download/38d1c843-1601-11e7-8af5-581e00000009"
}
]
}
Отдельный пользовательский шаблон
Отдельный пользовательский шаблон
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: customerorder тип сущности, для которой запрашивается стандартный шаблон. |
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id отдельного шаблона. |
Запрос на получение информации об отдельном пользовательском шаблоне печатной формы для указанного типа сущности по его id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/customtemplate/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление пользовательского шаблона для данного типа сущности.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009",
"type": "customtemplate",
"mediaType": "application/json"
},
"id": "38d1c843-1601-11e7-8af5-581e00000009",
"name": "достаточно_нестандартный_шаблон",
"type": "entity",
"content": "https://online.moysklad.ru/api/remap/1.2/download/38d1c843-1601-11e7-8af5-581e00000009"
}
Пользовательские шаблоны для ценников и этикеток
Атрибуты сущности
- meta - Метаданные о пользовательском шаблоне
- id - id шаблона
- name - наименование шаблона
- type - тип шаблона (mxtemplate - тип шаблона для ценников и этикеток)
- content - ссылка на скачивание
Список пользовательских ценников и этикеток
Запрос на получение информации о пользовательских шаблонах печатных форм для товаров, модификаций, услуг и комплектов.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/customtemplate/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка пользовательских шаблонов для товаров, модификаций, услуг и комплектов.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate",
"type": "embeddedtemplate",
"mediaType": "application/json",
"size": 2,
"limit": 100,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate/a8218d14-6017-3ba4-85c4-254fff93bbc8",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "a8218d14-6017-3ba4-85c4-254fff93bbc8",
"name": "Термоэтикетка (58х40мм)",
"type": "mxtemplate",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/termo_58x40.xml"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate/2746190f-cf7c-3a0b-922d-e75f44e88cce",
"type": "embeddedtemplate",
"mediaType": "application/json"
},
"id": "2746190f-cf7c-3a0b-922d-e75f44e88cce",
"name": "Ценник (70x49,5мм)",
"type": "mxtemplate",
"content": "https://online.moysklad.ru/api/remap/1.2/download-template/price_tag_70x49.5.xml"
}
]
}
Отдельный пользовательский шаблон для ценников и этикеток
Отдельный пользовательский ценник или этикетка
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id отдельного шаблона. |
Запрос на получение информации об отдельном пользовательском шаблоне печатной формы для товаров, модификаций, услуг и комплектов по его id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/customtemplate/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление пользовательского шаблона для товаров, модификаций, услуг и комплектов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/customtemplate/a4d36b88-d329-4b73-966a-b66b6a1b1b9a",
"type": "customtemplate",
"mediaType": "application/json"
},
"id": "a4d36b88-d329-4b73-966a-b66b6a1b1b9a",
"name": "NewCustomTemplate",
"type": "mxtemplate",
"content": "https://online.moysklad.ru/api/remap/1.2/download/a4d36b88-d329-4b73-966a-b66b6a1b1b9a"
}
Печать документов
Средствами JSON API можно запрашивать печать документов с помощью шаблонов печатных форм. При запросе на формирование печатной формы сервер при готовности документа, корректной печатной форме и правильном формате запроса отвечает пустым ответом с кодом 303. В заголовке Location ответа содержится адрес временного расположения готовой к загрузке печатной формы. Файл во временном расположении доступен для загрузки в течение 5 минут.
Сервер может вернуть ответ 202 и заголовок Location с адресом для опроса готовности печатной формы к загрузке. Данный вариант будет реализован позже.
Печать документа
Запрос на печать
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: demand тип сущности, для которой запрашивается печать. |
| id | string (required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности, для которой запрашивается печать. |
Запрос на печать отдельного документа по шаблону печатной формы.
Атрибуты запроса
- template - Ссылка на шаблон для печати в формате Метаданных
- extension - расширение, в котором нужно напечатать форму. Можно указать
xls, pdf, html, ods
Также можно напечатать комплект документов. Для этого вместо поля template нужно указать поле templates, которое является массивом объектов со следующими полями: + template - Ссылка на шаблон для печати в формате Метаданных + count - Количество копий печатной формы. От 1 до 10.
Если в запросе будет как поле templates так и поле template (вне элемента массива templates), произойдёт ошибка. В запросе допустимо только 1 из этих полей. При печати комплектов не нужно указывать поле extension - все комплекты печатаются в pdf.
При печати комплекта, для определённых сущностей можно использовать шаблоны для печати связанных документов. Так, например, для отгрузки (demand) можно использовать шаблоны: + Счёт покупателю + Счёт покупателю с печатью и подписью + Заказ покупателя + Счёт-фактура выданный + Любой пользовательский шаблон для вышеперечисленных сущностей.
для заказа покупателя: + Любой стандартный (embeddedtemplate) шаблон для отгрузки. + Счёт покупателю + Счёт покупателю с печатью и подписью + Счёт-фактура выданный + Любой пользовательский шаблон для вышеперечисленных сущностей.
для счёта покупателю: + Любой стандартный (embeddedtemplate) шаблон для отгрузки. + Заказ покупателя + Счёт-фактура выданный + Любой пользовательский шаблон для вышеперечисленных сущностей.
Пример запроса на печать отдельного документа по шаблону печатной формы.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/export/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/daca545a-1a35-11e7-8a84-bae500000001",
"type": "customtemplate",
"mediaType": "application/json"
}
},
"extension": "xls"
}'
Response 202 Headers
Location: ссылка на статус печати
Content-Type: application/json
Response 303 Headers
Location: ссылка на файл
Content-Type: application/json
Пример запроса на печать комплекта документов. В результате запроса будет напечатан комплект в сумме из 6 печатных форм.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/export/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"templates": [
{
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/daca545a-1a35-11e7-8a84-bae500000001",
"type": "customtemplate",
"mediaType": "application/json"
}
},
"count": 2
},
{
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/embeddedtemplate/3d2685b4-cf64-4fd1-87c8-e109966b364b",
"type": "embeddedtemplate",
"mediaType": "application/json"
}
},
"count": 3
},
{
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata/embeddedtemplate/6f3c9a47-6772-4944-9723-92d0d7be2a9c",
"type": "embeddedtemplate",
"mediaType": "application/json"
}
},
"count": 1
}
]
}'
Response 202 Headers
Location: ссылка на статус печати
Content-Type: application/json
Response 303 Headers
Location: ссылка на файл
Content-Type: application/json
Печать этикеток и ценников
Средствами JSON API можно запрашивать печать этикеток и ценников с помощью шаблонов печатных форм. При запросе на формирование печатной формы сервер при готовности этикеток и ценников, корректной печатной форме и правильном формате запроса отвечает пустым ответом с кодом 303. В заголовке Location ответа содержится адрес временного расположения готовой к загрузке печатной формы. Файл во временном расположении доступен для загрузки в течение 5 минут.
Сервер может вернуть ответ 202 и заголовок Location с адресом для опроса готовности печатной формы к загрузке. Данный вариант будет реализован позже.
Печать этикеток и ценников доступна для товаров, услуг, комплектов и модификаций.
Печать этикеток и ценников
Запрос на печать этикеток и ценников
Запрос на печать этикеток и ценников по шаблону печатной формы.
Атрибуты запроса
- organization - Ссылка на ваше юрлицо в формате Метаданных
- count - Количество ценников/термоэтикеток. Максимальное количество -
1000 - salePrice - Цена продажи
- priceType - Ссылка на тип цены в формате Метаданных
- template - Ссылка на шаблон для печати в формате Метаданных
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: product тип сущности, для которой запрашивается печать. |
| id | string (required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности, для которой запрашивается печать. |
Пример запроса на печать этикеток и ценников по шаблону печатной формы для товаров.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/product/a86708d2-f8d3-4e67-8f04-6101158da808/export/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/107430bc-36e7-11e7-8a7f-40d000000090",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=107430bc-36e7-11e7-8a7f-40d000000090"
}
},
"count": 10,
"salePrice": {
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
}
}
},
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/assortment/metadata/embeddedtemplate/f8e295eb-15c6-3184-b934-14fe90b3ea81",
"type": "embeddedtemplate",
"mediaType": "application/json"
}
}
}'
Response 202 Headers
Location: ссылка на статус печати
Content-Type: application/json
Response 303 Headers
Location: ссылка на файл
Content-Type: application/json
Публикация документов
JSON API позволяет опубликовать для общего пользования печатную форму документа, созданную на основе шаблона печатной формы. Кодом сущности для публикации в составе JSON API является ключевое слово publication.
Работа пользователя с публикациями документов возможна, если есть право на чтение и право печати сущности данного типа.
Публикации доступны только для следующих типов: Заказ покупателя, Счет покупателю, Отгрузка, Заказ поставщику, Счет поставщика, Приемка, Входящий платеж, Приходный ордер, Исходящий платеж, Расходный ордер, Внутренний заказ, Перемещение, Оприходование, Списание, Счет-фактура выданный, Счет-фактура полученный, Возврат поставщику, Возврат покупателя, Выплата денег, Внесение денег, Розничный возврат, Розничная продажа, Договор, Розничная смена, Заказ на производство, Полученный отчёт комиссионера, Выданный отчёт комиссионера, Инвентаризация, Тех. Операция.
Публикации
Атрибуты сущности
- meta - Метаданные Публикации
- template - Ссылка на шаблон для печати в формате Метаданных
- href - Ссылка на страницу Публикации
Получить публикации
Запрос на получение списка Публикаций по указанному документу.
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: demand тип сущности, по которой получить Публикации. |
| id | string (required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности, по которой получить Публикации. |
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/publication"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Публикаций.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication/aec51463-bbd2-11e6-8a84-bae500000003",
"type": "operationpublication",
"mediaType": "application/json"
},
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009",
"type": "customtemplate",
"mediaType": "application/json"
}
},
"href": "https://doc.moysklad.ru/board/f4917c19-2346-11e7-1542-821d00000001/publication/aec51463-bbd2-11e6-8a84-bae500000003.html"
}
]
}
Создать публикацию
Запрос на публикацию документа.
Публикация документа происходит на основании переданного объекта JSON, который должен содержать ссылку на шаблона для печати документа template в формате Метаданных. Если публикация была ранее создана, то ответ будет со статусом 200.
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: demand тип сущности, по которой получить Публикации. |
| id | string (required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности, по которой получить Публикации. |
Пример (application/json)
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/publication"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009",
"type": "customtemplate",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление ранее созданной Публикации.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication/aec51463-bbd2-11e6-8a84-bae500000003",
"type": "operationpublication",
"mediaType": "application/json"
},
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009",
"type": "customtemplate",
"mediaType": "application/json"
}
},
"href": "https://doc.moysklad.ru/board/f4917c19-2346-11e7-1542-821d00000001/publication/aec51463-bbd2-11e6-8a84-bae500000003.html"
}
Response 201 (application/json) Успешный запрос. Результат - JSON представление созданной Публикации.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication/aec51463-bbd2-11e6-8a84-bae500000003",
"type": "operationpublication",
"mediaType": "application/json"
},
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009",
"type": "customtemplate",
"mediaType": "application/json"
}
},
"href": "https://doc.moysklad.ru/board/f4917c19-2346-11e7-1542-821d00000001/publication/aec51463-bbd2-11e6-8a84-bae500000003.html"
}
Публикация
Удалить публикацию
Запрос на удаление Публикации с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: demand тип сущности. |
| id | string (required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности. |
| publicationId | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Публикации. |
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/publication/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 204 (application/json) Успешное удаление Публикации.
Получить публикацию
Запрос на получение Публикации с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: demand тип сущности. |
| id | string (required) Example: a86708d2-f8d3-4e67-8f04-6101158da808 id сущности. |
| publicationId | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Публикации. |
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand/a86708d2-f8d3-4e67-8f04-6101158da808/publication/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Публикации.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/0b71daec-055e-11e6-9464-e4de0000007e/publication/aec51463-bbd2-11e6-8a84-bae500000003",
"type": "operationpublication",
"mediaType": "application/json"
},
"template": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/customtemplate/38d1c843-1601-11e7-8af5-581e00000009",
"type": "customtemplate",
"mediaType": "application/json"
}
},
"href": "https://doc.moysklad.ru/board/f4917c19-2346-11e7-1542-821d00000001/publication/aec51463-bbd2-11e6-8a84-bae500000003.html"
}
Задача
Средствами JSON API можно создавать и обновлять сведения о задачах, запрашивать списки задач и сведения по отдельным задачам. Кодом сущности для задачи в составе JSON API является ключевое слово task. Больше о задачах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Задачи
Атрибуты сущности
- meta - Метаданные задачи
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - author - Сотрудник создавший задачу. В формате Метаданных
Только для чтения - created - Момент создания задачи
Только для чтения - updated - Момент последнего обновления сущности
Только для чтения - description - Текст задачи
Необходимое - dueToDate - Срок задачи
- assignee - Сотрудник, ответственный за выполнение задачи. В формате Метаданных
Необходимое - done - Отметка о выполнении задачи.
- completed - Время выполнения задачи.
Только для чтения - implementer - Сотрудник выполнивший задачу. В формате Метаданных
Только для чтения - agent - Контрагент или юрлицо, связанное с задачей. Задача может быть привязана либо к конрагенту, либо к юрлицу, либо к документу. В формате Метаданных
- operation - Документ, связанный с задачей. Задача может быть привязана либо к конрагенту, либо к юрлицу, либо к документу. В формате Метаданных
- notes - Ссылка на комментарии к задаче в формате Метаданных
Комментарии задачи
Объект комментария к задаче содержит следующие поля:
+ author - Сотрудник создавший комментарий. В формате Метаданных Только для чтения
+ moment - Момент создания комментария Только для чтения
+ description - Текст комментария Необходимое
Отображение списка по умолчанию
Для администратора
Если текущий сотрудник обладает правами администратора, то при запросе списка задач ему будут выведены все активные (done = false) задачи, как те, что относятся к нему (сотрудник является создателем или исполнителем задачи), так и те, что относятся к другим сотрудникам.
Для сотрудника
Для сотрудника, не являющегося администратором, но имеющего право на просмотр всех задач, список задач по умолчанию будет аналогичен списку задач, выводимому для администратора. В противном случае, при запросе списка задач без каких-либо фильтров, будут выведены активные (done = false) задачи, которые создал текущий сотрудник и задачи, за которые ответственен текущий сотрудник.
Фильтры из web-интерфейса
В основном интерфейсе МоегоСклада для отображения списка задач существует 2 группы фильтров:
+ Фильтр по связанности с текущим сотрудником: Поручено мне, Я поручил, Все задачи (отображается только у администраторов)
+ Фильтр по готовности задачи: Активные, Выполненные.
Чтобы реализовать подобную фильтрацию списка для JSON API, нужно использовать следующие фильтры для списка задач:
+ Поручено мне: фильтр по полю assignee в значении которого указана ссылка на текущего сотрудника
https://online.moysklad.ru/api/remap/1.2/entity/task?filter=assignee=http://online.moysklad.ru/api/remap/1.2/entity/employee/<id текущего сотрудника>
+ Я поручил: фильтр по полю author в значении которого указана ссылка на текущего сотрудника
https://online.moysklad.ru/api/remap/1.2/entity/task?filter=author=http://online.moysklad.ru/api/remap/1.2/entity/employee/<id текущего сотрудника>
+ Все задачи: не требует фильтрации. Обратите внимание на пункт Отображение списка по умолчанию
+ Активные: фильтр по полю done со значением false
https://online.moysklad.ru/api/remap/1.2/entity/task?filter=done=false
+ Выполненные: фильтр по полю done со значением true
https://online.moysklad.ru/api/remap/1.2/entity/task?filter=done=true
Права доступа
| Операция | Доступ |
|---|---|
| Просмотр задач в которых текущий пользователь является ответственным или автором | Все |
| Просмотр любых задач | пользователь с правом на просмотр всех задач или администратор |
| Создание задачи | необходима тарифная опция CRM, все |
| Редактирование задачи | необходима тарифная опция CRM, администратор, создатель задачи |
| Выполнение задачи | необходима тарифная опция CRM, администратор, создатель задачи, ответственный |
| Отмена выполнения задачи | необходима тарифная опция CRM, администратор, создатель задачи, ответственный |
| Удаление задачи | Администратор, создатель задачи |
Получить задачи
Получить список задач. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Задачи.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить задачи
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/task"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка задач.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task",
"type": "task",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/task/metadata",
"type": "task",
"mediaType": "application/json"
},
"id": "47bc1d9b-8b87-11e8-d9ce-84d900000017",
"accountId": "98182760-8aa1-11e8-7210-075e00000001",
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"created": "2018-07-19 22:09:37",
"updated": "2018-07-19 22:10:01",
"description": "task3",
"dueToDate": "2018-07-20 22:09:00",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"done": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/992b6965-8aa1-11e8-7210-075e00000057",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=992b6965-8aa1-11e8-7210-075e00000057"
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes",
"type": "tasknote",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/aaca57a2-8b86-11e8-d9ce-84d900000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/task/metadata",
"type": "task",
"mediaType": "application/json"
},
"id": "aaca57a2-8b86-11e8-d9ce-84d900000007",
"accountId": "98182760-8aa1-11e8-7210-075e00000001",
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"created": "2018-07-19 22:05:14",
"updated": "2018-07-19 22:09:42",
"description": "task1",
"dueToDate": "2018-07-20 22:05:00",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"done": false,
"operation": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/7eb5b552-8aa3-11e8-7210-075e000000f1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#supply/edit?id=7eb5b552-8aa3-11e8-7210-075e000000f1"
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/aaca57a2-8b86-11e8-d9ce-84d900000007/notes",
"type": "tasknote",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
]
}
Создать Задачу
Создать новую задачу. Для создания новых задач необходима активная тарифная опция (https://support.moysklad.ru/hc/ru/articles/216649748-CRM-%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D0%BA%D0%BB%D0%B8%D0%B5%D0%BD%D1%82%D1%81%D0%BA%D0%BE%D0%B9-%D0%B1%D0%B0%D0%B7%D0%BE%D0%B9).
Пример запроса на создание новой задачи.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/task"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"description": "Исправить реквизиты юрлица",
"dueToDate": "2017-05-12 17:12:00",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"done": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/9927bf0d-8aa1-11e8-7210-075e00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной задачи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/cfe5a6ae-8b87-11e8-d9ce-84d900000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/task/metadata",
"type": "task",
"mediaType": "application/json"
},
"id": "cfe5a6ae-8b87-11e8-d9ce-84d900000000",
"accountId": "98182760-8aa1-11e8-7210-075e00000001",
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"created": "2018-07-19 22:13:25",
"updated": "2018-07-19 22:13:25",
"description": "Исправить реквизиты юрлица",
"dueToDate": "2017-05-12 17:12:00",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"done": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/9927bf0d-8aa1-11e8-7210-075e00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=9927bf0d-8aa1-11e8-7210-075e00000054"
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/cfe5a6ae-8b87-11e8-d9ce-84d900000000/notes",
"type": "tasknote",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
Массовое создание и обновление Задач
Массовое создание и обновление Задач. В теле запроса нужно передать массив, содержащий JSON представления Задач, которые вы хотите создать или обновить. Обновляемые Задачи должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Задач
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/task"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"description": "Исправить реквизиты юрлица",
"dueToDate": "2017-05-12 17:12:00",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"done": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/9927bf0d-8aa1-11e8-7210-075e00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/cfe5a6ae-8b87-11e8-d9ce-84d900000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/task/metadata",
"type": "task",
"mediaType": "application/json"
},
"description": "Уточнить контактные лица",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"done": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/992b6965-8aa1-11e8-7210-075e00000057",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Задач.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/9971ba00-8b88-11e8-d9ce-84d900000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/task/metadata",
"type": "task",
"mediaType": "application/json"
},
"id": "9971ba00-8b88-11e8-d9ce-84d900000009",
"accountId": "98182760-8aa1-11e8-7210-075e00000001",
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"created": "2018-07-19 22:19:04",
"updated": "2018-07-19 22:19:04",
"description": "Исправить реквизиты юрлица",
"dueToDate": "2017-05-12 17:12:00",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"done": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/9927bf0d-8aa1-11e8-7210-075e00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=9927bf0d-8aa1-11e8-7210-075e00000054"
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/9971ba00-8b88-11e8-d9ce-84d900000009/notes",
"type": "tasknote",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/cfe5a6ae-8b87-11e8-d9ce-84d900000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/task/metadata",
"type": "task",
"mediaType": "application/json"
},
"id": "cfe5a6ae-8b87-11e8-d9ce-84d900000000",
"accountId": "98182760-8aa1-11e8-7210-075e00000001",
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"created": "2018-07-19 22:13:25",
"updated": "2018-07-19 22:19:04",
"description": "Уточнить контактные лица",
"dueToDate": "2017-05-12 17:12:00",
"implementer": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"completed": "2018-07-19 22:19:04",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"done": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/992b6965-8aa1-11e8-7210-075e00000057",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=992b6965-8aa1-11e8-7210-075e00000057"
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/cfe5a6ae-8b87-11e8-d9ce-84d900000000/notes",
"type": "tasknote",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
]
Удалить задачу
Запрос на удаление задачи с указанным id. Для удаления задач необходима активная тарифная опция (https://support.moysklad.ru/hc/ru/articles/216649748-CRM-%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D0%BA%D0%BB%D0%B8%D0%B5%D0%BD%D1%82%D1%81%D0%BA%D0%BE%D0%B9-%D0%B1%D0%B0%D0%B7%D0%BE%D0%B9). Также нельзя удалить задачи, созданные другими сотрудниками, без прав администратора.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id задачи. |
Запрос на удаление задачи с указанным id.
shell curl -X DELETE "https://online.moysklad.ru/api/remap/1.2/entity/task/7944ef04-f831-11e5-7a69-971500188b19" -H "Authorization: Basic <Access-Token>"Response 200 (application/json) Успешное удаление задачи.
Задача
Получить задачу
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id задачи. |
Запрос на получение отдельной задачи с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/task/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление задачи с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/task/metadata",
"type": "task",
"mediaType": "application/json"
},
"id": "47bc1d9b-8b87-11e8-d9ce-84d900000017",
"accountId": "98182760-8aa1-11e8-7210-075e00000001",
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"created": "2018-07-19 22:09:37",
"updated": "2018-07-19 22:13:10",
"description": "task3",
"dueToDate": "2018-07-20 22:09:00",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"done": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/9927bf0d-8aa1-11e8-7210-075e00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=9927bf0d-8aa1-11e8-7210-075e00000054"
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes",
"type": "tasknote",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Изменить задачу
Описание
Изменить задачу с указанным id. Для изменения задач необходима активная тарифная опция (https://support.moysklad.ru/hc/ru/articles/216649748-CRM-%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D0%BA%D0%BB%D0%B8%D0%B5%D0%BD%D1%82%D1%81%D0%BA%D0%BE%D0%B9-%D0%B1%D0%B0%D0%B7%D0%BE%D0%B9). Также нельзя изменять задачи, созданные другими сотрудниками, без прав администратора.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id задачи. |
Пример запроса на обновление существующей задачи.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/task/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"description": "Уточнить контактные лица",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"done": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/9927bf0d-8aa1-11e8-7210-075e00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=9927bf0d-8aa1-11e8-7210-075e00000054"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой задачи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/task/metadata",
"type": "task",
"mediaType": "application/json"
},
"id": "47bc1d9b-8b87-11e8-d9ce-84d900000017",
"accountId": "98182760-8aa1-11e8-7210-075e00000001",
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"created": "2018-07-19 22:09:37",
"updated": "2018-07-19 22:24:50",
"description": "Уточнить контактные лица",
"dueToDate": "2018-07-20 22:09:00",
"implementer": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"completed": "2018-07-19 22:24:24",
"assignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"done": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/9927bf0d-8aa1-11e8-7210-075e00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=9927bf0d-8aa1-11e8-7210-075e00000054"
}
},
"notes": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes",
"type": "tasknote",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Комментарии Задачи
Отдельный ресурс для управления комментариями Задачи. С его помощью вы можете управлять комментариями задачи, в которой количество комментариев превышает лимит на количество комментариев, сохраняемых вместе с задачей. Этот лимит равен 100.
Получить комментарии Задачи
Запрос на получение списка всех комментариев данной Задачи. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой комментарии Задачи.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id задачи. |
| limit | number (optional) Default: 25 Example: 100 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 100. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей |
| updatedFrom | string (optional) Example: 2016-04-15 15:48:46 Один из параметров фильтрации выборки. Формат строки : ГГГГ-ММ-ДД ЧЧ:ММ:СС[.ммм], Часовой пояс: MSK (Московское время) |
| updatedTo | string (optional) Example: 2016-04-15 15:48:46 Один из параметров фильтрации выборки. Формат строки : ГГГГ-ММ-ДД ЧЧ:ММ:СС[.ммм], Часовой пояс: MSK (Московское время) |
| updatedBy | string (optional) Example: admin@admin Один из параметров фильтрации выборки. Формат строки : uid |
Получить комментарии Задачи
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/task/7944ef04-f831-11e5-7a69-971500188b19/notes"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка комментариев отдельной Задачи.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes",
"type": "tasknote",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes/55eaa2cc-8b87-11e8-d9ce-84d900000025",
"type": "tasknote",
"mediaType": "application/json"
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"text": "текст комментария 1",
"moment": "2018-07-19 22:10:01"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes/55eaac82-8b87-11e8-d9ce-84d900000026",
"type": "tasknote",
"mediaType": "application/json"
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"text": "текст комментария 2",
"moment": "2018-07-19 22:10:01"
}
]
}
Создать комментарий Задачи
Запрос на создание нового комментария к Задаче.
Для успешного создания необходимо в теле запроса указать следующие поля:
+ text - Текст комментария. Необходимое
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id задачи. |
Пример создания одного комментария к Задаче.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/task/7944ef04-f831-11e5-7a69-971500188b19/notes"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"text": "текст комментрания 3"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного комментария отдельной Задачи.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes/5528751f-8b8a-11e8-d9ce-84d90000000f",
"type": "tasknote",
"mediaType": "application/json"
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"text": "текст комментрания 3",
"moment": "2018-07-19 22:31:28"
}
]
Пример создания сразу нескольких комментариев к Задаче.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/task/7944ef04-f831-11e5-7a69-971500188b19/notes"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"text": "текст комментрания 4"
},
{
"text": "текст комментрания 5"
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка созданных комментариев отдельной Задачи.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes/8ba69d28-8b8a-11e8-d9ce-84d900000012",
"type": "tasknote",
"mediaType": "application/json"
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"text": "текст комментрания 4",
"moment": "2018-07-19 22:32:59"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes/8ba6a80c-8b8a-11e8-d9ce-84d900000013",
"type": "tasknote",
"mediaType": "application/json"
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"text": "текст комментрания 5",
"moment": "2018-07-19 22:32:59"
}
]
Комментарий к задаче
Получить комментарий к Задаче
Отдельный комментарий к Задаче с указанным id комментария.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id задачи. |
| tasknoteID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id комментария к Задаче. |
Запрос на получение отдельного комментарии к Задаче с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/task/7944ef04-f831-11e5-7a69-971500188b19/notes/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного комментария к Задаче.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes/55eaa2cc-8b87-11e8-d9ce-84d900000025",
"type": "tasknote",
"mediaType": "application/json"
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"text": "текст комментария 1",
"moment": "2018-07-19 22:10:01"
}
Изменить комментарий к Задаче
Запрос на обновление отдельной комментарии к Задаче.
Для успешного создания необходимо в теле запроса указать следующие поля:
+ text - Текст комментария. Необходимое
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id задачи. |
| tasknoteID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id комментария к Задаче. |
Пример запроса на обновление отдельного комментария к Задаче.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/task/7944ef04-f831-11e5-7a69-971500188b19/notes/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"text": "новый текст комментария 1"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого комментария к Задаче.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/task/47bc1d9b-8b87-11e8-d9ce-84d900000017/notes/55eaa2cc-8b87-11e8-d9ce-84d900000025",
"type": "tasknote",
"mediaType": "application/json"
},
"author": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/98fa7086-8aa1-11e8-7210-075e0000002c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=98fa7086-8aa1-11e8-7210-075e0000002c"
}
},
"text": "новый текст комментария 1",
"moment": "2018-07-19 22:10:01"
}
Удалить комментарий
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id задачи. |
| tasknoteID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id комментария к Задаче. |
Запрос на удаление отдельного комментария к Задаче с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/task/7944ef04-f831-11e5-7a69-971500188b19/notes/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление комментария к Задаче.
Бонусная операция
Бонусные операции
Средствами JSON API можно создавать и обновлять сведения о Бонусных операциях, запрашивать списки Бонусных операций и сведения по отдельным Бонусым операциям. Кодом сущности для Бонусной операции в составе JSON API является ключевое слово bonustransaction.
Атрибуты сущности
- meta - Метаданные бонусной операции
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- updated - Момент последнего обновления Бонусной операции
- created - Момент создания Бонусной операции
- group - Отдел сотрудника в формате Метаданных
- externalCode - Внешний код Бонусной операции
- name - Наименование бонусной операции
- applicable - Отметка о проведении
- moment - Время проведения бонусной операции
- agent - Контрагент, связанный с бонусной операцией в формате Метаданных
Необходимое - parentDocument - Связанный документ бонусной операции в формате Метаданных
- bonusProgram - Бонусная программа в формате Метаданных
Необходимое - bonusValue - Количество бонусных баллов
- organization - ссылка на ваше юрлицо в формате Метаданных
- transactionType - Тип бонусной операции. Возможные значения:
EARNING,SPENDING.Необходимое
Атрибуты доступные для фильтрации
- id - ID в формате UUID
- moment - Момент создания бонусной операции
- updated - Момент последнего обновления бонусной операции
- updatedBy - Автор последнего обновления бонусной операции в формате
uid(admin@admin) - agent - Ссылка на контрагента в формате Метаданных
- bonusProgram - Ссылка на бонусную программу в формате Метаданных
- bonusValue - Бонусные баллы
Получить Бонусные операции
Запрос на получения списка всех Бонусных операций для данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Бонусные операции.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Бонусные операции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Бонусных операций.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/?limit=5",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"size": 4,
"limit": 5,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7c6ecd51-b738-11e8-727d-307300000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#bonustransaction/edit?id=7c6ecd51-b738-11e8-727d-307300000028"
},
"id": "7c6ecd51-b738-11e8-727d-307300000028",
"accountId": "ba5d8717-d6e7-4741-9f2e-4e343a447fb9",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/4a980e02-b685-11e8-727d-30730000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=4a980e02-b685-11e8-727d-30730000002b"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/4427b6f1-b685-11e8-727d-307300000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-09-13 12:36:26",
"name": "d00001",
"externalCode": "htdrUVpciRX4kldKIN7VL0",
"moment": "2018-09-13 12:36:26",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9fea1d90-d488-4271-97bc-a9ad1b9fbcc0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=9fea1d90-d488-4271-97bc-a9ad1b9fbcc0"
}
},
"created": "2018-09-13 12:36:26",
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/956f6ff7-718f-4849-be47-7509fdd18db9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=956f6ff7-718f-4849-be47-7509fdd18db9"
}
},
"bonusValue": 15,
"transactionType": "EARNING"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7c6ecd51-b738-11e8-727d-307300000029",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#bonustransaction/edit?id=7c6ecd51-b738-11e8-727d-307300000029"
},
"id": "7c6ecd51-b738-11e8-727d-307300000029",
"accountId": "ba5d8717-d6e7-4741-9f2e-4e343a447fb9",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/4a980e02-b685-11e8-727d-30730000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=4a980e02-b685-11e8-727d-30730000002b"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/4427b6f1-b685-11e8-727d-307300000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-09-13 12:36:26",
"name": "updated_name",
"externalCode": "atdrUVpciRX4kljKIN7iL8",
"moment": "2018-09-13 12:36:26",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9fea1d90-d488-4271-97bc-a9ad1b9fbcc0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=9fea1d90-d488-4271-97bc-a9ad1b9fbcc0"
}
},
"created": "2018-09-13 12:36:26",
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/956f6ff7-718f-4849-be47-7509fdd18db9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=956f6ff7-718f-4849-be47-7509fdd18db9"
}
},
"bonusValue": 1235,
"transactionType": "EARNING"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7c6ecd51-b738-11e8-727d-307300000038",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#bonustransaction/edit?id=7c6ecd51-b738-11e8-727d-307300000038"
},
"id": "7c6ecd51-b738-11e8-727d-307300000038",
"accountId": "ba5d8717-d6e7-4741-9f2e-4e343a447fb9",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/4a980e02-b685-11e8-727d-30730000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=4a980e02-b685-11e8-727d-30730000002b"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/4427b6f1-b685-11e8-727d-307300000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-09-13 12:36:26",
"name": "d00003",
"externalCode": "ald88VpciRX4kkklIN7123",
"moment": "2018-09-13 12:36:26",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9fea1d90-d488-4271-97bc-a9ad1b9fbcc0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=9fea1d90-d488-4271-97bc-a9ad1b9fbcc0"
}
},
"created": "2018-09-13 12:36:26",
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/956f6ff7-718f-4849-be47-7509fdd18db9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=956f6ff7-718f-4849-be47-7509fdd18db9"
}
},
"bonusValue": 100500,
"transactionType": "SPENDING"
}
]
}
Создать Бонусную операцию
Запрос на создание новой бонусной операции на данной учётной записи.
Пример запроса на создание новой бонусной операции.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "d00001",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/45457cb8-f473-4618-ab19-2294c328f4ba",
"type": "counterparty",
"mediaType": "application/json"
}
},
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/fc2666ba-5d39-4a60-8105-4b678180b059",
"type": "bonusprogram",
"mediaType": "application/json"
}
},
"parentDocument": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b0b7d56-2a44-4aa2-adc2-a49dadd61af0",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"transactionType": "EARNING",
"bonusValue": 15
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной бонусной операции.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7c6ecd51-b738-11e8-727d-307300000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#bonustransaction/edit?id=7c6ecd51-b738-11e8-727d-307300000028"
},
"id": "7c6ecd51-b738-11e8-727d-307300000028",
"accountId": "44245b3a-b685-11e8-727d-307300000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/4a980e02-b685-11e8-727d-30730000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=4a980e02-b685-11e8-727d-30730000002b"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/4427b6f1-b685-11e8-727d-307300000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-09-13 12:36:26",
"name": "d000001",
"externalCode": "htdrUVpciRX4kldKIN7VL0",
"moment": "2018-09-13 12:36:00",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/341a6b49-b688-11e8-727d-307300000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=341a6b49-b688-11e8-727d-307300000012"
}
},
"created": "2018-09-13 12:36:26",
"parentDocument": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/e182ab48-b726-11e8-727d-3073000000b4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#retaildemand/edit?id=e182ab48-b726-11e8-727d-3073000000b4"
}
},
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/3cc6edd8-b688-11e8-727d-30730000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=3cc6edd8-b688-11e8-727d-30730000001b"
}
},
"bonusValue": 15,
"transactionType": "EARNING"
}
Массовое создание и обновление Бонусных операций
Массовое создание и обновление Бонусных операций. В теле запроса нужно передать массив, содержащий JSON представления Бонусных операций, которые вы хотите создать или обновить. Обновляемые Бонусные операции должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Бонусных операций
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "d00001",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9fea1d90-d488-4271-97bc-a9ad1b9fbcc0",
"type": "counterparty",
"mediaType": "application/json"
}
},
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/956f6ff7-718f-4849-be47-7509fdd18db9",
"type": "bonusprogram",
"mediaType": "application/json"
}
},
"transactionType": "EARNING",
"bonusValue": 15
},
{
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9fea1d90-d488-4271-97bc-a9ad1b9fbcc0",
"type": "counterparty",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/956f6ff7-718f-4849-be47-7509fdd18db9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json"
},
"name": "updated_name",
"bonusValue": 1235
},
{
"name": "d00003",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9fea1d90-d488-4271-97bc-a9ad1b9fbcc0",
"type": "counterparty",
"mediaType": "application/json"
}
},
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/956f6ff7-718f-4849-be47-7509fdd18db9",
"type": "bonusprogram",
"mediaType": "application/json"
}
},
"transactionType": "SPENDING",
"bonusValue": 100500
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Бонусных операций.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7c6ecd51-b738-11e8-727d-307300000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#bonustransaction/edit?id=7c6ecd51-b738-11e8-727d-307300000028"
},
"id": "7c6ecd51-b738-11e8-727d-307300000028",
"accountId": "ba5d8717-d6e7-4741-9f2e-4e343a447fb9",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/4a980e02-b685-11e8-727d-30730000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=4a980e02-b685-11e8-727d-30730000002b"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/4427b6f1-b685-11e8-727d-307300000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-09-13 12:36:26",
"name": "d00001",
"externalCode": "htdrUVpciRX4kldKIN7VL0",
"moment": "2018-09-13 12:36:26",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9fea1d90-d488-4271-97bc-a9ad1b9fbcc0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=9fea1d90-d488-4271-97bc-a9ad1b9fbcc0"
}
},
"created": "2018-09-13 12:36:26",
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/956f6ff7-718f-4849-be47-7509fdd18db9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=956f6ff7-718f-4849-be47-7509fdd18db9"
}
},
"bonusValue": 15,
"transactionType": "EARNING"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7c6ecd51-b738-11e8-727d-307300000029",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#bonustransaction/edit?id=7c6ecd51-b738-11e8-727d-307300000029"
},
"id": "7c6ecd51-b738-11e8-727d-307300000029",
"accountId": "ba5d8717-d6e7-4741-9f2e-4e343a447fb9",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/4a980e02-b685-11e8-727d-30730000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=4a980e02-b685-11e8-727d-30730000002b"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/4427b6f1-b685-11e8-727d-307300000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-09-13 12:36:26",
"name": "updated_name",
"externalCode": "atdrUVpciRX4kljKIN7iL8",
"moment": "2018-09-13 12:36:26",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9fea1d90-d488-4271-97bc-a9ad1b9fbcc0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=9fea1d90-d488-4271-97bc-a9ad1b9fbcc0"
}
},
"created": "2018-09-13 12:36:26",
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/956f6ff7-718f-4849-be47-7509fdd18db9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=956f6ff7-718f-4849-be47-7509fdd18db9"
}
},
"bonusValue": 1235,
"transactionType": "EARNING"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7c6ecd51-b738-11e8-727d-307300000038",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#bonustransaction/edit?id=7c6ecd51-b738-11e8-727d-307300000038"
},
"id": "7c6ecd51-b738-11e8-727d-307300000038",
"accountId": "ba5d8717-d6e7-4741-9f2e-4e343a447fb9",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/4a980e02-b685-11e8-727d-30730000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=4a980e02-b685-11e8-727d-30730000002b"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/4427b6f1-b685-11e8-727d-307300000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-09-13 12:36:26",
"name": "d00003",
"externalCode": "ald88VpciRX4kkklIN7123",
"moment": "2018-09-13 12:36:26",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9fea1d90-d488-4271-97bc-a9ad1b9fbcc0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=9fea1d90-d488-4271-97bc-a9ad1b9fbcc0"
}
},
"created": "2018-09-13 12:36:26",
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/956f6ff7-718f-4849-be47-7509fdd18db9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=956f6ff7-718f-4849-be47-7509fdd18db9"
}
},
"bonusValue": 100500,
"transactionType": "SPENDING"
}
]
Удалить Бонусную операцию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Бонусной операции. |
Запрос на удаление бонусной операции.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Бонусной операции.
Бонусная операция
Получить Бонусную операцию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Бонусной операции. |
Запрос на получение бонусной операции с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Бонусной операции с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7c6ecd51-b738-11e8-727d-307300000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#bonustransaction/edit?id=7c6ecd51-b738-11e8-727d-307300000028"
},
"id": "7c6ecd51-b738-11e8-727d-307300000028",
"accountId": "44245b3a-b685-11e8-727d-307300000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/4a980e02-b685-11e8-727d-30730000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=4a980e02-b685-11e8-727d-30730000002b"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/4427b6f1-b685-11e8-727d-307300000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-09-13 12:36:26",
"name": "d000013",
"externalCode": "htdrUVpciRX4kldKIN7VL0",
"moment": "2018-09-13 12:36:00",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/341a6b49-b688-11e8-727d-307300000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=341a6b49-b688-11e8-727d-307300000012"
}
},
"created": "2018-09-13 12:36:26",
"parentDocument": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/e182ab48-b726-11e8-727d-3073000000b4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#retaildemand/edit?id=e182ab48-b726-11e8-727d-3073000000b4"
}
},
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/3cc6edd8-b688-11e8-727d-30730000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=3cc6edd8-b688-11e8-727d-30730000001b"
}
},
"bonusValue": 15,
"transactionType": "EARNING"
}
Изменить Бонусную операцию
Запрос на изменение объекта, представляющего собой бонусную операцию. Невозможно изменение типа бонусной операции.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Бонусной операции. |
Пример запроса на обновление Бонусной операции.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"bonusValue": 15524
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Бонусной операции.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/d8dda7b8-b76d-11e8-727d-3073000000a2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonustransaction/metadata",
"type": "bonustransaction",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#bonustransaction/edit?id=d8dda7b8-b76d-11e8-727d-3073000000a2"
},
"id": "d8dda7b8-b76d-11e8-727d-3073000000a2",
"accountId": "44245b3a-b685-11e8-727d-307300000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/4a980e02-b685-11e8-727d-30730000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=4a980e02-b685-11e8-727d-30730000002b"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/4427b6f1-b685-11e8-727d-307300000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2018-09-14 10:19:54",
"name": "name_change",
"externalCode": "dzmLEueIjUHccIa6GP6UX2",
"moment": "2018-09-13 18:58:00",
"applicable": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/4ac8d7ea-b685-11e8-727d-307300000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=4ac8d7ea-b685-11e8-727d-307300000056"
}
},
"created": "2018-09-13 18:58:25",
"parentDocument": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/90f4f8df-b76b-11e8-727d-307300000090",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#retaildemand/edit?id=90f4f8df-b76b-11e8-727d-307300000090"
}
},
"bonusProgram": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/3cc6edd8-b688-11e8-727d-30730000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=3cc6edd8-b688-11e8-727d-30730000001b"
}
},
"bonusValue": 15524,
"transactionType": "SPENDING"
}
Бонусная программа
Бонусные программы
Кодом сущности для Бонусных программ в составе JSON API является ключевое слово bonusprogram. Операции создания и изменения не поддерживаются. Перед работой со скидками настоятельно рекомендуем вам прочитать вот эту статью на портале поддержки МоегоСклада.
Атрибуты сущности
- meta - Метаданные
- id - ID скидки в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - name - Наименование бонусной программы.
- active - Индикатор, является ли бонусная программа активной на данный момент
- allProducts - Индикатор, действует ли бонусная программа на все товары (всегда
true, см. Скидки) - agentTags - Тэги контрагентов, к которым применяется бонусная программа, если применяется не ко всем контрагентам
- earnRateRoublesToPoint - Курс начисления
- spendRatePointsToRouble - Курс списания
- maxPaidRatePercents - Максимальный процент оплаты баллами
Получить все Бонусные программы
Запрос на получение всех бонусных программ учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой бонусные программы.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить все Бонусные программы
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - список всех бонусных программ для учетной записи.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/1223d051-ba76-11e8-3353-995e0000005a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=1223d051-ba76-11e8-3353-995e0000005a"
},
"id": "1223d051-ba76-11e8-3353-995e0000005a",
"accountId": "dbb8cfc1-cbfa-11e1-6dfb-889ffa6f49fd",
"name": "test",
"active": true,
"earnRateRoublesToPoint": 1,
"spendRatePointsToRouble": 1,
"maxPaidRatePercents": 100
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/87c69fae-c1ad-4700-a852-f21939470760",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=1223d051-ba76-11e8-3353-995e0000005a"
},
"id": "87c69fae-c1ad-4700-a852-f21939470760",
"accountId": "dbb8cfc1-cbfa-11e1-6dfb-889ffa6f49fd",
"name": "bonusprogram",
"active": false,
"agentTags": [
"группа агентов"
],
"earnRateRoublesToPoint": 7,
"spendRatePointsToRouble": 4,
"maxPaidRatePercents": 50
}
]
}
Бонусная программа
Получить Бонусную программу
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 87c69fae-c1ad-4700-a852-f21939470760 id Бонусной программы. |
Запрос на получение отдельной бонусной программы с указанным id
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/87c69fae-c1ad-4700-a852-f21939470760"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Бонусной программы с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/87c69fae-c1ad-4700-a852-f21939470760",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/metadata",
"type": "bonusprogram",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#discount/edit?id=1223d051-ba76-11e8-3353-995e0000005a"
},
"id": "87c69fae-c1ad-4700-a852-f21939470760",
"accountId": "dbb8cfc1-cbfa-11e1-6dfb-889ffa6f49fd",
"name": "bonusprogram",
"active": false,
"agentTags": [
"группа агентов"
],
"earnRateRoublesToPoint": 7,
"spendRatePointsToRouble": 4,
"maxPaidRatePercents": 50
}
Удалить Бонусную программу
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 87c69fae-c1ad-4700-a852-f21939470760 id Бонусной программы. |
Запрос на удаление бонусной программы
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/bonusprogram/87c69fae-c1ad-4700-a852-f21939470760"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Бонусной программы
Статусы документов
Статусы можно добавлять, изменять и удалять через api
Статусы
Атрибуты сущности
- meta - Метаданные о Статусе
Только для чтения - id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - name - Наименование Статуса
Необходимое - color - Цвет Статуса
Необходимое - stateType - Тип Статуса
Необходимое
Возможные значения: [Regular(обычный), Successful(Финальный положительный), Unsuccessful(Финальный отрицательный)].
Значение по умолчанию - Regular
- entityType - Тип сущности, к которой относится Статус (ключевое слово в рамках JSON API)
Только для чтения
Поле color передаётся в АПИ как целое число состоящее из 4х байт. Т.к. цвет передаётся в цветовом пространстве ARGB, каждый байт отвечает за свой цвет соответственно: 1 - за прозрачность, 2 - за красный цвет, 3 - за зелёный, 4 - за синий. Каждый байт принимает значения от 0 до 255 как и цвет в каждом из каналов цветового пространства. Получившееся в итоге из 4 записанных последовательно байт число, переведённое в 10-чную систему счисления и является представлением цвета статуса в JSON API.
Пример: цвету rgb(162, 198, 23) будет соответствовать следующее значение поля "color": 10667543.
Посмотреть списки существующих статусов можно в контексте метаданных
документа, например сделав GET запрос по URL http://online.moysklad.ru/api/remap/1.2/entity/demand/metadata
Список статусов для документа demand(Отгрузка) будет выведен в коллекции states.
Получить метаданные
Параметры
| Параметр | Описание |
|---|---|
| entityType | string (required) Example: counterparty тип сущности. |
Получить метаданные и в том числе статусы
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json)
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty",
"mediaType": "application/json"
},
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/4f70c518-60a1-11e7-6adb-ede500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
},
"id": "4f70c518-60a1-11e7-6adb-ede500000003",
"accountId": "0af94520-54f7-11e7-6adb-ede500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "counterparty"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/3b6eb61a-60c5-11e7-6adb-ede500000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
},
"id": "3b6eb61a-60c5-11e7-6adb-ede500000001",
"accountId": "0af94520-54f7-11e7-6adb-ede500000001",
"name": "Подписан договор",
"color": 10667543,
"stateType": "Successful",
"entityType": "counterparty"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/3b6fd06a-60c5-11e7-6adb-ede500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
},
"id": "3b6fd06a-60c5-11e7-6adb-ede500000002",
"accountId": "0af94520-54f7-11e7-6adb-ede500000001",
"name": "Отклонен",
"color": 10774205,
"stateType": "Unsuccessful",
"entityType": "counterparty"
}
],
"createShared": false
}
Создать статус
Создать новый статус.
Описание
Статус создаётся на основе переданного объекта JSON,
который содержит представление нового Статуса.
Результат - JSON представление созданного Статуса. Для создания нового Статуса,
необходимо и достаточно указать в переданном объекте не пустые поля name, color, stateType.
Параметры
| Параметр | Описание |
|---|---|
| entityType | string (required) Example: counterparty тип сущности. |
Создание одного статуса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Одобрено",
"color": 69446,
"stateType": "Regular"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Статуса.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/6262b270-60c3-11e7-6adb-ede50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
},
"id": "6262b270-60c3-11e7-6adb-ede50000000d",
"accountId": "0af94520-54f7-11e7-6adb-ede500000001",
"name": "Одобрено",
"color": 69446,
"stateType": "Regular",
"entityType": "counterparty"
}
Обновить статус
Обновить существующий статус.
Описание
Статус обновляется на основе переданного объекта JSON.
Результат - JSON представление обновленного или созданного Статуса.
Для обновления Статуса, необходимо указать в переданном объекте
одно или несколько полей с новыми значениями: name, color, stateType.
Параметры
| Параметр | Описание |
|---|---|
| entityType | string (required) Example: counterparty тип сущности. |
| id | string (required) Example: 4dcb3f23-60c4-11e7-6adb-ede500000019 id Статуса. |
Обновление статуса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/4dcb3f23-60c4-11e7-6adb-ede500000019"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"color": 255,
"stateType": "Regular"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновленного Статуса.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/6262b270-60c3-11e7-6adb-ede50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
},
"id": "6262b270-60c3-11e7-6adb-ede50000000d",
"accountId": "0af94520-54f7-11e7-6adb-ede500000001",
"name": "Одобрено",
"color": 255,
"stateType": "Regular",
"entityType": "counterparty"
}
Массовое создание и обновление Статусов
Массовое создание и обновление Статусов. В теле запроса нужно передать массив, содержащий JSON представления Статусов, которые вы хотите создать или обновить. Обновляемые Статусы должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Статусов
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/metadata/states"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "На рассмотрении",
"color": 8767198,
"stateType": "Regular"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/b56215dc-60c3-11e7-6adb-ede500000013",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
},
"name": "На подписании",
"color": 34617,
"stateType": "Regular"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Статусов.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/b55d2ddf-60c3-11e7-6adb-ede500000010",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
},
"id": "b55d2ddf-60c3-11e7-6adb-ede500000010",
"accountId": "0af94520-54f7-11e7-6adb-ede500000001",
"name": "На рассмотрении",
"color": 8767198,
"stateType": "Regular",
"entityType": "counterparty"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/b56215dc-60c3-11e7-6adb-ede500000013",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "state",
"mediaType": "application/json"
},
"id": "b56215dc-60c3-11e7-6adb-ede500000013",
"accountId": "0af94520-54f7-11e7-6adb-ede500000001",
"name": "На подписании",
"color": 34617,
"stateType": "Regular",
"entityType": "counterparty"
}
]
Удалить Статус
Параметры
| Параметр | Описание |
|---|---|
| entityType | string (required) Example: counterparty тип сущности. |
| id | string (required) Example: 4dcb3f23-60c4-11e7-6adb-ede500000019 id Статуса. |
Запрос на удаление Статуса с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata/states/4dcb3f23-60c4-11e7-6adb-ede500000019"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Статуса.
Документы
Документ Общие сведения
Шаблоны документов
Шаблон - предзаполненный стандартными полями JSON-объект, который затем можно использовать для успешного создания документа.
Средствами JSON API можно получать предзаполненные шаблоны документов. Они могут быть предзаполнены как на основе других документов, так и стандартными значениями без связей с другими документами.
Для этого, во всех документах, по которым можно получить шаблон, существует специальный ресурс Шаблон документа, адрес которого формируется следующим образом:
https://online.moysklad.ru/api/remap/1.2/entity/<ключевое слово для документа>/new
В тело PUT запроса по данному ресурсу нужно передать метаданные документа, на основе которого будет создан шаблон нового документа, либо просто передать пустое тело запроса.
Метаданные должны быть "обёрнуты" в объект, имя которого есть ключевое слово для документа-основания в JSON API.
Для каждого из данных ресурсов есть примеры запросов и ответов.
На данный момент можно получить шаблоны следующих документы на основании других:
| Документ | Основание, на котором он может быть создан |
|---|---|
| Возврат покупателя (salesreturn) | Отгрузка (demand), Розничная продажа (retaildemand) |
| Возврат поставщику (purchasereturn) | Приёмка (supply) |
| Отгрузка (demand) | Заказ покупателя (customerorder) |
| Счет поставщика (invoicein) | Заказ поставщику (purchaseorder) |
| Cчет покупателю (invoiceout) | Заказ покупателя (customerorder) |
| Списание (loss) | Возврат покупателя (salesreturn), инвентаризация(inventory) |
| Оприходование (enter) | Инвентаризация(inventory) |
| Заказ поставщику (purchaseorder) | Внутренний заказ (internalorder) |
| Перемещение (move) | Внутренний заказ (internalorder) |
| Приходный ордер (cashin) | Заказ покупателя (salesreturn), Возврат поставщику (purchasereturn), Отгрузка (demand), Счёт покупателю (invoiceout), Полученный отчёт комиссионера (commissionreportin) |
| Расходный ордер (cashout) | Возврат покупателя (salesreturn), Приёмка (supply), Счёт поставщика (invoicein), Заказ поставщику (purchaseorder), Выданный отчёт комиссионера (commissionreportout) |
| Входящий платёж (paymentin) | Заказ покупателя (salesreturn), Возврат поставщику (purchasereturn), Отгрузка (demand), Счёт покупателю (invoiceout), Полученный отчёт комиссионера (commissionreportin) |
| Исходящий платёж (paymentout) | Возврат покупателя (salesreturn), Приёмка (supply), Счёт поставщика (invoicein), Заказ поставщику (purchaseorder), Выданный отчёт комиссионера (commissionreportout) |
| Тех. операция (processing) | Заказ на производство (processingorder), Тех. карта (processingplan) |
| Заказ на производство (processingorder) | Тех. карта (processingplan) |
| Розничная продажа (retaildemand) | Розничная смена, Заказ покупателя |
В результате PUT запроса по /entity/entityName/new НЕ будет создано нового документа.
Возвращаемый предзаполненный объект является лишь "болванкой" с некоторыми заполненными полями (поля заполняются по той же логике,
что и в аналогичной ситуации в основном интерфейсе), облегчающей создание документа. Он не сохраняется в системе. Этот
объект затем можно передать в теле запроса на создание соответствующего документа и тогда уже документ будет создан, и связан с документом-основанием.
Если послать на данный ресурс пустое тело запроса, то в итоговом шаблоне будут предзаполнены лишь стандартные поля в т.ч. указанные в настройках пользователя
в учётной записи сервиса МойСклад.
С подробностями и примерами по каждому из документов можно ознакомиться в соответствующих разделах документации. Например, для шаблона отгрузки - смотреть в Шаблонах отгрузки
Контекстный поиск для документов
В JSON API можно осуществлять контекстный поиск среди списка сущностей определённого типа по их строковым полям. Для этого
используется URI параметр фильтрации search.
+ search
Параметр фильтрации, с помощью которого можно осуществить поиск в списке сущностей. Поиск происходит по основным строковым полям сущностей данного
типа. Результатом поиска будет отсортированный по релевантности список сущностей данного типа, прошедших фильтрацию по переданной поисковой строке. В отличии от фильтрации выборки
с помощью параметра filter, при которой значения проверяются на точное совпадение указанным, при контекстном поиске проверка на совпадение не строгая.
Таким образом, если осуществлять фильтрацию вида ../entity/<entity_type>?filter=name=иван в отфильтрованную выборку попадут только те сущности, поле name
у которых имеет значение иван и никакие другие. При контекстном поиске вида ../entity/<entity_type>?search=иван будут выведены как сущности с name равным
иван, так и сущности, в имени (или в другом строковом поле) которых иван просто содержится, например диван, иванова и т.п.
Поиск среди документов на соответствие поисковой строке будет осуществлён по следующим полям: + по наименованию (name) + по описанию (description) + по входящему номеру (incomingNumber)
- Примеры запросов контекстного поиска (значения должны быть urlencoded):
https://online.moysklad.ru/api/remap/1.2/entity/retaildemand?search=100https://online.moysklad.ru/api/remap/1.2/entity/salesreturn?search=бракhttps://online.moysklad.ru/api/remap/1.2/entity/retailshift?search=ночная
Удаление в корзину
Корзина позволяет избежать риска случайного удаления важных документов. Удаление в корзину доступно только при наличии у сотрудника соответствующих прав, а также настроек компании на использовании корзины.
Пример удаления Приёмки в корзину
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приёмки. |
Запрос на удаление Приёмки с указанным id в корзину.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/supply/be3a3a0e-370c-11e7-1542-821d00000001/trash"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешное удаление Приёмки.
Связи документов
Привязка документов к документам
Для того чтобы привязать к уже существующему документу другой документ нужно передать meta привязываемого документа в коллекцию связанных документов этого типа. Такие коллекции присутствуют среди аттрибутов документов. В описании сущностей они описаны в секции Связи с другими документами и каждое поле называется как ключевое слово для типов привязываемых документов во множественном числе. Например поле invoicesOut у отгрузок отвечает за связи с счетами покупателю. Если вы хотите привязать к отгрузке счёт, в это поле, в составе коллекции, нужно положить meta счёта покупателя который вы хотите привязать. Можно привязывать более 1 документа.
Пример привязки 1
Привязка внутреннего заказа к перемещению.
Параметры
| Параметр | Описание |
|---|---|
| docname | string (required) Example: move ключевое слово для документа со связями. |
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id документа. |
Пример запроса на привязку внутреннего заказа к перемещению.
curl -X PUT
"PUT https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"internalOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Результат - перемещение с заполненным полем internalOrder.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/d9318341-b0da-11e6-8a84-bae5000000c7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"id": "d9318341-b0da-11e6-8a84-bae5000000c7",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-22 20:41:07",
"name": "00001",
"externalCode": "8Fn2HqBbguhZxoYrjWYAf3",
"moment": "2016-11-22 20:40:00",
"applicable": true,
"sum": 0,
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/d9318341-b0da-11e6-8a84-bae5000000c7/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/85a8e439-b0d8-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"internalOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
}
Пример привязки 2
Второй пример запроса на привязку одного документа к другому.
Параметры
| Параметр | Описание |
|---|---|
| docname | string (required) Example: move ключевое слово для документа со связями. |
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id документа. |
Пример запроса на привязку счёта покупателю к отгрузке.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"invoicesOut": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Результат - отгрузка с новым элементом в коллекции invoicesOut.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/06406b97-9138-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "06406b97-9138-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-13 14:27:29",
"name": "000201",
"externalCode": "q5Ot--p3gHJrOFylVF2lQ2",
"moment": "2016-10-13 12:38:00",
"applicable": false,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/06406b97-9138-11e6-8a84-bae500000000/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"payedSum": 0,
"invoicesOut": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
}
}
]
}
Привязка платежей к документам
К некоторым документам в JSON API могут быть привязаны платежи. Платежи бывают 4-х типов: Входящий платёж, Приходный ордер, Исходящий платёж, Расходный ордер.
Документы, к которым могут быть привязаны платежи содержат вложенную коллекцию payments среди атрибутов докуента. Платежи в свою очередь содержат коллекцию operations - операции, к которым привязан данный платёж. Для того, чтобы привязать платёж к документу, нужно в запросах
на создание/обновление платежа в составе коллекции operations указать meta документа. Документы в этой коллекции могут иметь разный тип, однако это не значит, что к любому документу можно привязать все 4 типа платежей. Валидные типы платежей определяются самим документом, к которому происходит привязка. К примеру к полученному отчёту комиссионера можно привязать только входящий платёж или приходный ордер.
В результате привзяки платежа, в составе коллекции operations платежа появится новый объект, указывающий на документ, а в составе коллекции payments у документа, к которому
привязывается платёж, появится новый элемент ссылающийся на данный платёж.
Пример привязки платежа 1
Привязка входящего платежа к полученному отчёту комиссионера.
Параметры
| Параметр | Описание |
|---|---|
| docname2 | string (required) Example: commissionreportin ключевое слово для документа, к которому можно привязать платёж. |
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id документа. |
Пример запроса на привязку платежа к полученному отчёту комиссионера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Результат - входящий платёж с новым элементом в коллекции operations.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/94a9f8e9-b30b-11e6-8a84-bae500000017",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"id": "94a9f8e9-b30b-11e6-8a84-bae500000017",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 15:35:00",
"name": "lol2",
"externalCode": "-S9khhF3gNPa78SPCu81S2",
"moment": "2016-11-25 15:35:00",
"applicable": true,
"sum": 400,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942953e-9128-11e6-8a84-bae500000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/a8f3150d-9d39-11e6-8a84-bae500000074",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"vatSum": 0,
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Пример привязки платежа 2
Привязка приходного ордера к заказу покупателя.
Параметры
| Параметр | Описание |
|---|---|
| docname2 | string (required) Example: commissionreportin ключевое слово для документа, к которому можно привязать платёж. |
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id документа. |
Пример запроса на привязку приходного ордера к заказу покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/7944ef04-f831-11e5-7a69-971500188b19
"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Результат - приходный ордер с новым элементом в коллекции operations.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/834d731c-b313-11e6-8a84-bae50000008e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "834d731c-b313-11e6-8a84-bae50000008e",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 16:31:47",
"name": "1111",
"externalCode": "WpAtzal3hGUnUfQS55x781",
"moment": "2016-11-25 16:31:00",
"applicable": true,
"sum": 32131000,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"vatSum": 0,
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Документ Розничная смена
Розничные смены
Средствами JSON API можно запрашивать списки Розничных смен и сведения по отдельным Розничным сменам. Кодом сущности для Розничной смены в составе JSON API является ключевое слово retailshift.
Операции
С помощью данного ресурса вы не можете создавать или обновлять Розничные смены. Создание новой розничной смены происходит при выполнении запроса на Открытие смены через отдельный API подключения торговой точки к онлайн-сервису МойСклад POS API 1.0. Для совершения операции Открытие розничной смены необходимо аутентифицироваться с правами Кассира.
Атрибуты смены
- meta - Метаданные о смене
Только для чтения - id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - Номер смены
Только для чтения - description - Комментарий смены
Только для чтения - externalCode - Внешний код смены
Только для чтения - moment - Дата смены
Только для чтения - applicable - Отметка о проведении
Только для чтения - vatEnabled - Учитывается ли НДС
Только для чтения - vatIncluded - Включен ли НДС в цену
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
Только для чтения - shared - Общий доступ
Только для чтения - group - Отдел сотрудника в формате Метаданных
Только для чтения - organization - Ссылка на ваше юрлицо в формате Метаданных
Только для чтения - agent - Ссылка на контрагента в формате Метаданных
Только для чтения - store - Ссылка на склад в формате Метаданных
Только для чтения - contract - Ссылка на договор в формате Метаданных
Только для чтения - organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
Только для чтения - agentAccount - Ссылка на счёт контрагента в формате Метаданных
Только для чтения - attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - closeDate - Дата закрытия смены
Только для чтения - proceedsNoCash - Выручка безнал
Только для чтения - proceedsCash - Выручка наличными
Только для чтения - receivedNoCash - Получено безнал
Только для чтения - receivedCash - Получено наличными
Только для чтения - retailStore - Ссылка на точку продажи в формате Метаданных
Только для чтения - operations - Массив ссылок на связанные операции в формате Метаданных
Только для чтения - paymentOperations - Массив ссылок на платёжные операции в формате Метаданных
Только для чтения
О работе с доп. полями Розничных смен можно прочитать здесь
Получить Розничные смены
Запрос на получение списка всех Розничных смен на данной учётной записи. Результат успешного запроса - JSON представление списка Розничных смен с перечисленными полями: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Розничные смены.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Розничные смены
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Розничных смен.
{
"context": {
"employee": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift",
"type": "retailshift",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
},
"id": "0b2b2caf-055e-11e6-9464-e4de0000007c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-18 15:07:12",
"name": "00001",
"externalCode": "iR5ZTLzfhK98uzqIFbC871",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-18 15:06:51",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "Праздничная смена",
"type": "string",
"value": "Да"
}
],
"closeDate": "2016-04-18 15:07:12",
"proceedsNoCash": 0,
"proceedsCash": 5100,
"receivedNoCash": 0,
"receivedCash": 5136,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/29547f06-ec69-11e7-0532-9eed0000001b",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildemand/edit?id=29547f06-ec69-11e7-0532-9eed0000001b"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/3395a278-ec69-11e7-0532-9eed00000022",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retailsalesreturn/edit?id=3395a278-ec69-11e7-0532-9eed00000022"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/2eb3c0ad-f9d9-11e7-0532-9eed0000005a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashin/edit?id=2eb3c0ad-f9d9-11e7-0532-9eed0000005a"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/3d8258c5-f9d9-11e7-0532-9eed0000005e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashout/edit?id=3d8258c5-f9d9-11e7-0532-9eed0000005e"
}
}
],
"paymentOperations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/6c3237ff-f9d9-11e7-0532-9eed00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#cashin/edit?id=6c3237ff-f9d9-11e7-0532-9eed00000086"
},
"linkedSum": 0
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/5952a2fb-f9d8-11e7-0532-9eed00000036",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#paymentin/edit?id=5952a2fb-f9d8-11e7-0532-9eed00000036"
},
"linkedSum": 0
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/cd86df19-0563-11e6-9464-e4de0000008e",
"type": "retailshift",
"mediaType": "application/json"
},
"id": "cd86df19-0563-11e6-9464-e4de0000008e",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-18 15:48:19",
"name": "00002",
"externalCode": "uhM2bdwAg7661Qhx3f7102",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-18 15:48:04",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "Праздничная смена",
"type": "string",
"value": "Да"
}
],
"closeDate": "2016-04-18 15:48:19",
"proceedsNoCash": 1800,
"proceedsCash": 0,
"receivedNoCash": 0,
"receivedCash": 0,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/29547f06-ec69-11e7-0532-9eed0000002c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildemand/edit?id=29547f06-ec69-11e7-0532-9eed0000002c"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/3395a278-ec69-11e7-0532-9eed00000033",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retailsalesreturn/edit?id=3395a278-ec69-11e7-0532-9eed00000033"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/2eb3c0ad-f9d9-11e7-0532-9eed0000006b",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashin/edit?id=2eb3c0ad-f9d9-11e7-0532-9eed0000006b"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/3d8258c5-f9d9-11e7-0532-9eed0000006a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashout/edit?id=3d8258c5-f9d9-11e7-0532-9eed0000006a"
}
}
],
"paymentOperations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/6c3237ff-f9d9-11e7-0532-9eed00000099",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#cashin/edit?id=6c3237ff-f9d9-11e7-0532-9eed00000099"
},
"linkedSum": 0
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/5952a2fb-f9d8-11e7-0532-9eed00000048",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#paymentin/edit?id=5952a2fb-f9d8-11e7-0532-9eed00000048"
},
"linkedSum": 0
}
]
}
]
}
Удалить Розничную смену
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной смены. |
Запрос на удаление Розничной смены с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Розничной смены.
Метаданные Розничных смен
Метаданные Розничных смен
Запрос на получение метаданных Розничных смен. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Розничных смен + attributes - Массив объектов доп. полей Розничных смен в формате Метаданных + states - Массив статусов Розничных смен + createShared - создавать новые Розничные смены с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Розничных смен
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Розничных продаж.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/states/fb56cf4f-2e58-11e6-8a84-bae50000006b",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cf4f-2e58-11e6-8a84-bae50000006b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Собран",
"color": 8767198,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/states/fb56d433-2e58-11e6-8a84-bae50000006c",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d433-2e58-11e6-8a84-bae50000006c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отгружен",
"color": 10774205,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/states/fb56d92f-2e58-11e6-8a84-bae50000006d",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d92f-2e58-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Доставлен",
"color": 8825440,
"stateType": "Successful",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/states/fb56de0a-2e58-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56de0a-2e58-11e6-8a84-bae50000006e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Возврат",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/states/fb56e2b4-2e58-11e6-8a84-bae50000006f",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56e2b4-2e58-11e6-8a84-bae50000006f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отменен",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "customerorder"
}
],
"createShared": false
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata/attributes/d335f74e-558c-11e6-8a84-bae50000009a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d335f74e-558c-11e6-8a84-bae50000009a",
"name": "Приложение",
"type": "file",
"required": false
}
Розничная смена
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной смены. |
Получить Розничную смену
Запрос на получение отдельной Розничной смены с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailshift/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Розничной смены.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/91a42d66-0ad2-11e6-9464-e4de00000017",
"type": "retailshift",
"mediaType": "application/json"
},
"id": "91a42d66-0ad2-11e6-9464-e4de00000017",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-25 13:50:05",
"name": "00004",
"externalCode": "33Ox0o1GjpDZC9x41fUA11",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-25 13:10:19",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "Праздничная смена",
"type": "string",
"value": "Да"
}
],
"closeDate": "2016-04-25 13:10:19",
"proceedsNoCash": 0,
"proceedsCash": 0,
"receivedNoCash": 0,
"receivedCash": 0,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/29547f06-ec69-11e7-0532-9eed0000001b",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildemand/edit?id=29547f06-ec69-11e7-0532-9eed0000001b"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/3395a278-ec69-11e7-0532-9eed00000022",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retailsalesreturn/edit?id=3395a278-ec69-11e7-0532-9eed00000022"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/2eb3c0ad-f9d9-11e7-0532-9eed0000005a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashin/edit?id=2eb3c0ad-f9d9-11e7-0532-9eed0000005a"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/3d8258c5-f9d9-11e7-0532-9eed0000005e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#retaildrawercashout/edit?id=3d8258c5-f9d9-11e7-0532-9eed0000005e"
}
}
],
"paymentOperations": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/6c3237ff-f9d9-11e7-0532-9eed00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#cashin/edit?id=6c3237ff-f9d9-11e7-0532-9eed00000086"
},
"linkedSum": 0
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/5952a2fb-f9d8-11e7-0532-9eed00000036",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json",
"uuidHref": "http://online.moysklad.ru/app/#paymentin/edit?id=5952a2fb-f9d8-11e7-0532-9eed00000036"
},
"linkedSum": 0
}
]
}
Документ Оприходование
Средствами JSON API можно создавать и обновлять сведения об Оприходованиях, запрашивать списки Оприходований и сведения по отдельным Оприходованиям. Позициями Оприходований можно управлять как в составе отдельного Оприходования, так и отдельно - с помощью специальных ресурсов для управления позициями Оприходования. Кодом сущности для Оприходования в составе JSON API является ключевое слово enter. Больше об Оприходованиях можно прочитать этой ссылке.
Оприходования
Атрибуты сущности
- meta - Метаданные об Оприходованиях
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Оприходования
- description - Комментарий Оприходования
- externalCode - Внешний код Оприходования
- moment - Дата Оприходования
- applicable - Отметка о проведении
- sum - Сумма Оприходования в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- project - Ссылка на проект в формате Метаданных
- state - Статус Оприходования в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - positions - Ссылка на позиции Оприходования в формате Метаданных
- overhead - Накладные расходы. Если Позиции Оприходования не заданы, то накладные расходы нельзя задать
- sum - сумма накладных расходов
- distribution - Распределение накладных расходов
[weight, volume, price]->[по весу, по объёму, по цене]
Позиции Оприходования
Позиции Оприходования - это список товаров/услуг/модификаций/серий.
Объект позиции Оприходования содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ gtd - ГТД
+ country - Ссылка на страну в формате Метаданных
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ things - Серийные номера.
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
+ reason - Причина оприходования данной позиции
+ overhead - Накладные расходы. Если Позиции Оприходования не заданы, то накладные расходы нельзя задать
- sum - сумма накладных расходов
- distribution - Распределение накладных расходов [weight, volume, price] -> [по весу, по объёму, по цене]
С позициями можно работать с помощью специальных ресурсов для управления позициями Оприходования, а также в составе отдельного Оприходования. При работе в составе отдельного Оприходования, вы можете отправлять запросы на создание отдельного Оприходования с включенным в тело запроса массивом позиций Оприходования. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Оприходования". Также, при работе в составе отдельного Оприходования, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Оприходования. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Оприходования" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Оприходований можно прочитать здесь
Получать Оприходования
Запрос всех Оприходований на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Оприходований.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получать Оприходования
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Оприходований.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "2e12d827-5338-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 16:52:23",
"name": "00002",
"externalCode": "xmlPt1lUie1p18VedA1M-3",
"moment": "2016-07-26 16:51:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 26400,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/bf19f3fe-4f28-11e6-8a84-bae50000006d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "bf19f3fe-4f28-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 12:51:50",
"name": "00001",
"externalCode": "9CC4OgVhhJwPTl3289w0q1",
"moment": "2016-07-21 12:51:00",
"applicable": true,
"sum": 13200,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/bf19f3fe-4f28-11e6-8a84-bae50000006d/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
}
]
}
Создать Оприходования
Запрос на создание нового Оприходования
Пример создания нового Оприходования с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/enter"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "enter100",
"externalCode": "34981sawfa42kek",
"moment": "2016-06-21 16:56:52",
"applicable": true,
"sum": 51241240,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "АБЫР",
"overhead": 0
},
{
"quantity": 3,
"price": 333444,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Обновлённая причина",
"overhead": 0
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "Строковое поле",
"value": "Вот такое значение поля у оприходования"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "Числовое поле",
"value": 404
}
],
"overhead": {
"sum": 40400,
"distribution": "weight"
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Оприходования.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "7cfff21a-533b-11e6-8a84-bae50000001f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 17:16:04",
"name": "enter100",
"externalCode": "34981sawfa42kek",
"moment": "2016-06-21 16:56:52",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1026732,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "Строковое поле",
"type": "string",
"value": "Вот такое значение поля у оприходования"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "Числовое поле",
"type": "long",
"value": 404
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"overhead": {
"sum": 40400,
"distribution": "weight"
}
}
Массовое создание и обновление Оприходований
Массовое создание и обновление Оприходований. В теле запроса нужно передать массив, содержащий JSON представления Оприходований, которые вы хотите создать или обновить. Обновляемые Оприходования должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Оприходований
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/enter"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "enter100",
"externalCode": "34981sawfa42kek",
"moment": "2016-06-21 16:56:52",
"applicable": true,
"sum": 51241240,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "АБЫР",
"overhead": 0
},
{
"quantity": 3,
"price": 333444,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Обновлённая причина",
"overhead": 0
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "Строковое поле",
"value": "Вот такое значение поля у оприходования"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "Числовое поле",
"value": 404
}
],
"overhead": {
"sum": 40400,
"distribution": "weight"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"name": "xX0enter0Xx",
"externalCode": "21721bddSAKDAbw21eh",
"moment": "2012-12-21 13:46:22",
"applicable": false,
"sum": 333,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"value": "Поменяли стрковое доп поле"
},
{
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"value": 501
}
],
"positions": [],
"overhead": {
"sum": 40400,
"distribution": "price"
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Оприходований.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "7cfff21a-533b-11e6-8a84-bae50000001f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 17:16:04",
"name": "enter100",
"externalCode": "34981sawfa42kek",
"moment": "2016-06-21 16:56:52",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1026732,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "Строковое поле",
"type": "string",
"value": "Вот такое значение поля у оприходования"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "Числовое поле",
"type": "long",
"value": 404
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"overhead": {
"sum": 40400,
"distribution": "weight"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "7cfff21a-533b-11e6-8a84-bae50000001f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 17:21:18",
"name": "xX0enter0Xx",
"externalCode": "21721bddSAKDAbw21eh",
"moment": "2012-12-21 12:46:22",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "Строковое поле",
"type": "string",
"value": "Поменяли стрковое доп поле"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "Числовое поле",
"type": "long",
"value": 501
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
]
Удалить Оприходование
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
Запрос на удаление Оприходования с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Оприходования.
Метаданные Оприходований
Метаданные Оприходований
Запрос на получение метаданных Оприходований. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Оприходований + attributes - Массив объектов доп. полей Оприходований в формате Метаданных + states - Массив статусов Оприходований + createShared - создавать новые Оприходования с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Оприходований
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных Оприходований.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "Строковое поле",
"type": "string",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "Числовое поле",
"type": "long",
"required": false
}
],
"createShared": false
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "Строковое поле",
"type": "string",
"required": false
}
Оприходование
Получить Оприходование
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
Запрос на получение отдельного оприходования с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Оприходования.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "2e12d827-5338-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 16:52:23",
"name": "00002",
"externalCode": "xmlPt1lUie1p18VedA1M-3",
"moment": "2016-07-26 16:51:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 26400,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
}
}
Изменить Оприходование
Запрос на обновление оприходования с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
Пример запроса на обновление отдельного Оприходования.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "xX0enter0Xx",
"externalCode": "21721bddSAKDAbw21eh",
"moment": "2012-12-21 13:46:22",
"applicable": false,
"sum": 333,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"value": "Поменяли стрковое доп поле"
},
{
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"value": 501
}
],
"positions": [],
"overhead": {
"sum": 40400,
"distribution": "price"
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Оприходования.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata",
"type": "enter",
"mediaType": "application/json"
},
"id": "7cfff21a-533b-11e6-8a84-bae50000001f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-26 17:21:18",
"name": "xX0enter0Xx",
"externalCode": "21721bddSAKDAbw21eh",
"moment": "2012-12-21 12:46:22",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9150cd-5338-11e6-8a84-bae50000009b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9150cd-5338-11e6-8a84-bae50000009b",
"name": "Строковое поле",
"type": "string",
"value": "Поменяли стрковое доп поле"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/metadata/attributes/6a9158b2-5338-11e6-8a84-bae50000009c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a9158b2-5338-11e6-8a84-bae50000009c",
"name": "Числовое поле",
"type": "long",
"value": 501
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/7cfff21a-533b-11e6-8a84-bae50000001f/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
Позиции Оприходований
Отдельный ресурс для управления позициями Оприходования. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Оприходования
Запрос на получение списка всех позиций данного Оприходования. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Оприходования.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Оприходования
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного Оприходования.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions",
"type": "enterposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions/2e12e9aa-5338-11e6-8a84-bae50000008f",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e12e9aa-5338-11e6-8a84-bae50000008f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"gtd": {
"name": "12345678/121217/1212321"
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"reason": "ЧТо то не так",
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions/2e12f062-5338-11e6-8a84-bae500000090",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e12f062-5338-11e6-8a84-bae500000090",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00de5b31-3303-11e6-8a84-bae500000344",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "НЕОБХОДИМО",
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions/2e12f5d2-5338-11e6-8a84-bae500000091",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e12f5d2-5338-11e6-8a84-bae500000091",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0572d2fc-3303-11e6-8a84-bae500000842",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions/2e12fb31-5338-11e6-8a84-bae500000092",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e12fb31-5338-11e6-8a84-bae500000092",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions/2e1300c8-5338-11e6-8a84-bae500000093",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e1300c8-5338-11e6-8a84-bae500000093",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 13200,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"gtd": {
"name": "12345678/121217/1235362"
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"reason": "АБЫР",
"overhead": 0
}
]
}
Создать позицию Оприходования
Запрос на создание новой позиции в Оприходовании. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Оприходования + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Оприходования. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
Пример создания позиций в Оприходовании.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 103,
"price": 566230,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Срочная нужда",
"overhead": 305
},
{
"quantity": 13,
"price": 12560,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Необходимый товар",
"overhead": 50607080
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного Оприходования.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions/7ffb0be4-5339-11e6-8a84-bae500000016",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "7ffb0be4-5339-11e6-8a84-bae500000016",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 103,
"price": 566230,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Срочная нужда",
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions/7ffb1271-5339-11e6-8a84-bae500000017",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "7ffb1271-5339-11e6-8a84-bae500000017",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 13,
"price": 12560,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Необходимый товар",
"overhead": 0
}
]
Позиция Оприходования
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции. |
Запрос на получение отдельной позиции Оприходования с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Оприходования.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions/2e12f062-5338-11e6-8a84-bae500000090",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "2e12f062-5338-11e6-8a84-bae500000090",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00de5b31-3303-11e6-8a84-bae500000344",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "НЕОБХОДИМО",
"overhead": 0
}
Изменить позицию
Запрос на обновление отдельной позиции Оприходования. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
|Параметр |Описание |
|---|---|
|id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования.|
|positionID| string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции.|
Пример запроса на обновление отдельной позиции в Оприходовании.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 3,
"price": 333444,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Обновлённая причина"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Оприходования.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/enter/2e12d827-5338-11e6-8a84-bae50000008e/positions/7ffb0be4-5339-11e6-8a84-bae500000016",
"type": "enterposition",
"mediaType": "application/json"
},
"id": "7ffb0be4-5339-11e6-8a84-bae500000016",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 3,
"price": 333444,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reason": "Обновлённая причина",
"overhead": 0
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Оприходования. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции. |
Запрос на удаление отдельной позиции Оприходования с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/enter/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Оприходования.
Документ Заказ покупателя
Заказы Покупателей
Средствами JSON API можно создавать и обновлять сведения о Заказах покупателя, запрашивать списки Заказов и сведения по отдельным Заказам Покупателей. Позициями Заказов можно управлять как в составе отдельного Заказа покупателя, так и отдельно - с помощью специальных ресурсов для управления позициями Заказа. Кодом сущности для Заказа покупателя в составе JSON API является ключевое слово customerOrder. Больше о Заказах Покупателей и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Атрибуты сущности
- meta - Метаданные о Заказе покупателя
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Заказа покупателя
- description - Комментарий Заказа покупателя
- externalCode - Внешний код Заказа покупателя
- moment - Дата Заказа
- applicable - Отметка о проведении
- vatIncluded - Включен ли НДС в цену
- vatEnabled - Учитывается ли НДС
- sum - Сумма Заказа в установленной валюте
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
- contract - Ссылка на договор в формате Метаданных
- state - Статус Заказа в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения positions - Ссылка на позиции в Заказе в формате Метаданных
reservedSum - Сумма товаров в резерве
Только для чтенияdeliveryPlannedMoment - Планируемая дата отгрузки
payedSum - Сумма входящих платежей по Заказу
Только для чтенияshippedSum - Сумма отгруженного
Только для чтенияinvoicedSum - Сумма счетов покупателю
Только для чтенияproject - Ссылка на проект в формате Метаданных
Связи с другими документами
- purchaseOrders - Массив ссылок на связанные заказы поставщикам в формате Метаданных
- demands - Массив ссылок на связанные отгрузки в формате Метаданных
- payments - Массив ссылок на связанные платежи в формате Метаданных
- invoicesOut - Массив ссылок на связанные счета покупателям в формате Метаданных
Позиции Заказа покупателя
Позиции Заказа - это список товаров/услуг/модификаций/серий.
Объект позиции Заказа содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ discount - Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10%
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ shipped - Доставлено
+ reserve - Резерв данной позиции
С позициями можно работать с помощью специальных ресурсов для управления позициями Заказа, а также в составе отдельного Заказа покупателя. При работе в составе отдельного Заказа покупателя, вы можете отправлять запросы на создание отдельного Заказа покупателя с включенным в тело запроса массивом позиций Заказа. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Заказа покупателя". Также, при работе в составе отдельного Заказа покупателя, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Заказа. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Заказа" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Заказов покупателей можно прочитать здесь
Получить список Заказов Покупателей
Запрос всех Заказов Покупателей на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Заказы Покупателей.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить список Заказов Покупателей
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Заказов Покупателей.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerOrder",
"type": "customerorder",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "34efe2ee-015e-11e6-9464-e4de0000006b",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 12:03:05",
"name": "00001",
"description": "Это комментарий к заказу покупателя!",
"externalCode": "CntjFix4hoyZOIhZiULjv2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-13 12:57:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 346453701206,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/bc1b4fde-019a-11e6-9464-e4de00000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 214
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "Атрибут заказа",
"type": "string",
"value": "1251252"
}
],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 346389501206,
"deliveryPlannedMoment": "2016-04-15 12:58:00",
"payedSum": 365939611804,
"shippedSum": 408739611676,
"invoicedSum": 408739611676
}
]
}
Создать Заказ покупателя
Запрос на создание нового Заказа покупателя. Обязательные для создания поля: + name - номер Заказа покупателя + organization - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на контрагента (покупателя) в формате Метаданных
Пример создания нового Заказа с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "00003",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/d9ceb08f-01ae-11e6-9464-e4de00000020",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "d9ceb08f-01ae-11e6-9464-e4de00000020",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:02:24",
"name": "00003",
"externalCode": "08ehdxhRgVIB5-Sa-QNI42",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-14 13:02:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/d9ceb08f-01ae-11e6-9464-e4de00000020/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример создания нового Заказа с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "000034",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "1243521",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"code": "1243521",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterperty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример запроса на создание Заказа покупателя с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name" : "000034",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"code" : "1243521",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"value": "Атрибут заказа",
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"code": "1243521",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "Атрибут заказа",
"type": "string",
"value": "Атрибут заказа",
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример запроса на создание Заказа покупателя с позициями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "000034",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "1243521",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 10
},
{
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 20
},
{
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "product",
"mediaType": "application/json"
}
},
"pack": {
"id": "1bf22e62-8b47-11e8-56c0-000800000006"
},
"reserve": 30
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"version": 0,
"updated": "2016-04-14 13:08:58",
"name": "000034",
"code": "1243521",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterperty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"documents": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/06406b97-9138-11e6-8a84-bae500000000/documents",
"mediaType": "application/json",
"size": 0,
"limit": 100,
"offset": 0
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 100,
"offset": 0
}
},
"reservedSum": 10000,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Массовое создание и обновление Заказов покупателей
Массовое создание и обновление Заказов покупателей. В теле запроса нужно передать массив, содержащий JSON представления Заказов покупателей, которые вы хотите создать или обновить. Обновляемые Заказы покупателей должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Заказов покупателей
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "00003",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"name": "000039",
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"externalCode": "championCode",
"code": "codeOfChampion",
"moment": "2013-04-19 13:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Заказов покупателей.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/d9ceb08f-01ae-11e6-9464-e4de00000020",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "d9ceb08f-01ae-11e6-9464-e4de00000020",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:02:24",
"name": "00003",
"externalCode": "08ehdxhRgVIB5-Sa-QNI42",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-14 13:02:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/d9ceb08f-01ae-11e6-9464-e4de00000020/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:30:05",
"name": "000039",
"code": "codeOfChampion",
"externalCode": "championCode",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2013-04-19 12:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
]
Удалить Заказ покупателя
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
Запрос на удаление Заказа покупателя с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Заказа покупателя.
Метаданные Заказов Покупателей
Метаданные Заказов Покупателей
Запрос на получение метаданных Заказов покупателей. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Заказов покупателей + attributes - Массив объектов доп. полей Заказов покупателей в формате Метаданных + states - Массив статусов Заказов покупателей + createShared - создавать новые Заказы покупателей с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Заказов Покупателей
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Заказов покупателей.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "Атрибут заказа",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56cf4f-2e58-11e6-8a84-bae50000006b",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cf4f-2e58-11e6-8a84-bae50000006b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Собран",
"color": 8767198,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56d433-2e58-11e6-8a84-bae50000006c",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d433-2e58-11e6-8a84-bae50000006c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отгружен",
"color": 10774205,
"stateType": "Regular",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56d92f-2e58-11e6-8a84-bae50000006d",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d92f-2e58-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Доставлен",
"color": 8825440,
"stateType": "Successful",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56de0a-2e58-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56de0a-2e58-11e6-8a84-bae50000006e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Возврат",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "customerorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56e2b4-2e58-11e6-8a84-bae50000006f",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56e2b4-2e58-11e6-8a84-bae50000006f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отменен",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "customerorder"
}
],
"createShared": false
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/attributes/57ab884e-558b-11e6-8a84-bae500000078",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "57ab884e-558b-11e6-8a84-bae500000078",
"name": "Товар по акции",
"type": "productfolder",
"required": false
}
Заказ покупателя
Получить Заказ покупателя
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
Запрос на получение отдельного Заказа покупателя с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerOrder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "34efe2ee-015e-11e6-9464-e4de0000006b",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 12:03:05",
"name": "00001",
"description": "Это комментарий к заказу покупателя!",
"externalCode": "CntjFix4hoyZOIhZiULjv2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-13 12:57:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 346453701206,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/bc1b4fde-019a-11e6-9464-e4de00000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 214
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": {
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "Атрибут заказа",
"value": "1251252"
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 346389501206,
"deliveryPlannedMoment": "2016-04-15 12:58:00",
"payedSum": 365939611804,
"shippedSum": 408739611676,
"invoicedSum": 408739611676
}
Изменить Заказ покупателя
Запрос на обновление Заказа покупателя с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Заказа покупателя, кроме тех, что
помечены Только для чтения в описании атрибутов Заказа покупателя.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
Пример запроса на обновление отдельного Заказа покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "000039",
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"externalCode": "championCode",
"code": "codeOfChampion",
"moment": "2013-04-19 13:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:30:05",
"name": "000039",
"code": "codeOfChampion",
"externalCode": "championCode",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2013-04-19 12:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример запроса на изменение Заказа покупателя с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "000039",
"externalCode": "championCode",
"code": "codeOfChampion",
"moment": "2013-04-19 13:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"value": "Обновлённый Атрибут заказа",
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:30:05",
"name": "000039",
"code": "codeOfChampion",
"externalCode": "championCode",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2013-04-19 12:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "Атрибут заказа",
"type": "string",
"value": "Обновлённый Атрибут заказа",
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Пример запроса на обновление Заказа покупателя с позициями в теле запроса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "000039",
"externalCode": "championCode",
"code": "codeOfChampion",
"moment": "2013-04-19 13:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 10
},
{
"id": "34f6344f-015e-11e6-9464-e4de0000006d",
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 20
},
{
"id": "34f6344f-015e-11e6-9464-e4de0000006e",
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 30
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:30:05",
"name": "000039",
"code": "codeOfChampion",
"externalCode": "championCode",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/ee2d9c89-1fea-4791-8c99-722e8f8294d0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2013-04-19 12:50:24",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/71d48933-fd85-11e5-9464-e4de00000005/accounts/71d4cfdb-fd85-11e5-9464-e4de00000006",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"reservedSum": 0,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Позиции Заказа покупателя
Отдельный ресурс для управления позициями Заказа покупателя. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Заказа покупателя
Запрос на получение списка всех позиций данного Заказа покупателя. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Заказа покупателя.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение списка всех позиций данного Заказа покупателя.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного Заказа покупателя.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 123050,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f6451e-015e-11e6-9464-e4de0000006d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6451e-015e-11e6-9464-e4de0000006d",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 64200000,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/60fc3826-00d7-11e6-9464-e4de00000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f6551d-015e-11e6-9464-e4de0000006e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6551d-015e-11e6-9464-e4de0000006e",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 346347237062,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/56c73633-ffe4-11e5-9464-e4de000000c6/d1bef0a1-ffe7-11e5-9464-e4de0000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reserve": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f66948-015e-11e6-9464-e4de0000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f66948-015e-11e6-9464-e4de0000006f",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 42141094,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66cc36dc-f7d2-11e5-8a84-bae500000074/671b5330-f7d2-11e5-8a84-bae500000088",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reserve": 1
}
]
}
Создать позицию Заказа покупателя
Запрос на создание новой позиции в Заказе покупателя. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию/комплект, которую представляет собой позиция. Также можно указать поле с именем product, service, consignment, variant, bundle в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Заказа + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
Пример создания одной позиции в Заказе покупателя.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 49,
"price": 12345,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 19
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного Заказа покупателя.
Пример создания сразу нескольких позиций в Заказе покупателя.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/eb93683d-01be-11e6-9464-e4de0000003c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "eb93683d-01be-11e6-9464-e4de0000003c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 10
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/eb937351-01be-11e6-9464-e4de0000003d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "eb937351-01be-11e6-9464-e4de0000003d",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 20
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/eb937d66-01be-11e6-9464-e4de0000003e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "eb937d66-01be-11e6-9464-e4de0000003e",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"pack": {
"id": "1bf22e62-8b47-11e8-56c0-000800000006",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/2ec1170c-3f69-4409-87bb-c68e0011b275",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 2
},
"reserve": 30
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка созданных позиций отдельного Заказа покупателя.
Позиция Заказа
Отдельная позиция Заказа с указанным id позиции.
Получить позицию Заказа
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа покупателя. |
Запрос на получение отдельной позиции Заказа с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 123050,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 1
}
Изменить позицию Заказа
Запрос на обновление отдельной позиции Заказа. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
|Параметр |Описание |
|---|---|
|id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя.|
|positionID| string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа покупателя.|
Пример запроса на обновление отдельной позиции в Заказе покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 111,
"price": 26332700,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 13
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Заказа покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 111,
"price": 26332700,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 13
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа покупателя. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа покупателя. |
Запрос на удаление отдельной позиции Заказа с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/customerorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Заказа.
Документ Заказ поставщику
Заказы Поставщикам
Средствами JSON API можно создавать и обновлять сведения о Заказах поставщику, запрашивать списки Заказов и сведения по отдельным Заказам Поставщикам. Позициями Заказов можно управлять как в составе отдельного Заказа поставщику, так и отдельно - с помощью специальных ресурсов для управления позициями Заказа. Кодом сущности для Заказа поставщику в составе JSON API является ключевое слово purchaseOrder. Больше о Заказах Поставщикам и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Атрибуты сущности
- meta - Метаданные о Заказе поставщику
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Заказа поставщику
- description - Комментарий Заказа поставщику
- externalCode - Внешний код Заказа поставщику
- moment - Дата Заказа
- applicable - Отметка о проведении
- vatIncluded - Включен ли НДС в цену
- vatEnabled - Учитывается ли НДС
- sum - Сумма Заказа в установленной валюте
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
- contract - Ссылка на договор в формате Метаданных
- state - Статус Заказа в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения - positions - Ссылка на позиции в Заказе в формате Метаданных
- deliveryPlannedMoment - Планируемая дата отгрузки
- payedSum - Сумма входящих платежей по Заказу
Только для чтения - shippedSum - Сумма отгруженного
Только для чтения - invoicedSum - Сумма счетов поставщика
Только для чтения - project - Ссылка на проект в формате Метаданных
- waitSum - Сумма товаров в пути
Связи с другими документами
- customerOrders - Массив ссылок на связанные заказы покупателей в формате Метаданных
- invoicesIn - Массив ссылок на связанные счета поставщиков в формате Метаданных
- payments - Массив ссылок на связанные платежи в формате Метаданных
- supplies - Массив ссылок на связанные приёмки в формате Метаданных
- internalOrder - Внутренний заказ, связанный с заказом поставщику, в формате Метаданных
Позиции Заказа поставщику
Позиции Заказа - это список товаров/услуг/модификаций/серий.
Объект позиции Заказа содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ discount - Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10%
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ shipped - Принято
+ wait - Ожидается данной позиции
С позициями можно работать с помощью специальных ресурсов для управления позициями Заказа, а также в составе отдельного Заказа поставщику. При работе в составе отдельного Заказа поставщику, вы можете отправлять запросы на создание отдельного Заказа поставщику с включенным в тело запроса массивом позиций Заказа. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Заказа поставщику". Также, при работе в составе отдельного Заказа поставщику, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Заказа. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Заказа" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Заказов поставщикам можно прочитать здесь
Получить список Заказов Поставщикам
Запрос всех Заказов Поставщикам на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Заказы Поставщикам.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить список Заказов Поставщикам
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Заказов Поставщикам.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "172fb2f6-3f70-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 12:42:13",
"name": "00002",
"description": "Кековый заказ конечно",
"externalCode": "FfSmVuSKi7h8L-jLADHV80",
"moment": "2016-07-01 12:40:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 5900,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/14ae5431-32ca-11e6-8a84-bae50000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2016-07-15 12:40:00",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 5900
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/403e7ea0-2e63-11e6-8a84-bae500000131",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "403e7ea0-2e63-11e6-8a84-bae500000131",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-10 10:06:46",
"name": "00001",
"externalCode": "pk6fh0NthbBSgrqI931uA0",
"moment": "2016-06-10 10:06:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf44002-2e58-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/403e7ea0-2e63-11e6-8a84-bae500000131/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2016-06-11 10:06:00",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0
}
]
}
Создать Заказ поставщику
Запрос на создание нового Заказа поставщику. Обязательные для создания поля: + name - номер Заказа поставщику + organization - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на контрагента (поставщику) в формате Метаданных
Пример создания нового Заказа.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "103034",
"description": "Типичный заказ поставщику",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "404",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"attributes": [
{
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"value": "Черный"
},
{
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"value": 0.4
},
{
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"value": true
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Заказа поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "22b4caaa-3f74-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 13:11:11",
"name": "103034",
"description": "Типичный заказ поставщику",
"code": "404",
"externalCode": "s30P0zlwg-1qxSZnRVONF0",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007/accounts/1483a4fa-32ca-11e6-8a84-bae500000008",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "Причина",
"type": "string",
"value": "Черный"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "Коэффициент",
"type": "double",
"value": 0.4
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "Кек?",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0
}
Пример запроса на создание Заказа поставщику с позициями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "777",
"description": "Типичный заказ поставщику",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "404",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"attributes": [
{
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"value": "Черный"
},
{
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"value": 0.4
},
{
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"value": true
}
],
"positions": [
{
"quantity": 12,
"price": 300,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"inTransit": 11
},
{
"quantity": 3,
"price": 1000,
"discount": 0,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"inTransit": 1
},
{
"quantity": 404,
"price": 454,
"discount": 200,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"inTransit": 216
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Заказа поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "ae7fa9fb-3f74-11e6-8a84-bae500000070",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 13:15:05",
"name": "777",
"description": "Типичный заказ поставщику",
"code": "404",
"externalCode": "37KNBm71gw7Zm00T5JdAt0",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 176816,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007/accounts/1483a4fa-32ca-11e6-8a84-bae500000008",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "Причина",
"type": "string",
"value": "Черный"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "Коэффициент",
"type": "double",
"value": 0.4
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "Кек?",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 5907132
}
Массовое создание и обновление Заказов поставщику
Массовое создание и обновление Заказов поставщику. В теле запроса нужно передать массив, содержащий JSON представления Заказов поставщику, которые вы хотите создать или обновить. Обновляемые Заказы поставщику должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Заказов поставщику
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "103034",
"description": "Типичный заказ поставщику",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"code": "404",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"attributes": [
{
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"value": "Черный"
},
{
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"value": 0.4
},
{
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"value": true
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"updated": "2016-07-01 13:15:05",
"name": "777",
"description": "Типичный заказ поставщику, с договором, другой валютой",
"code": "404",
"externalCode": "37KNBm7ф1gw7Zm00T5JdAt0",
"moment": "2016-12-05 15:30:14",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": null,
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"value": "Я всё ещё пишу для вас документацию"
},
{
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"value": 0.99
},
{
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": false,
"positions": [],
"deliveryPlannedMoment": "2016-02-15 14:12:19"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Заказов поставщику.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "22b4caaa-3f74-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 13:11:11",
"name": "103034",
"description": "Типичный заказ поставщику",
"code": "404",
"externalCode": "s30P0zlwg-1qxSZnRVONF0",
"moment": "2016-12-05 15:30:14",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007/accounts/1483a4fa-32ca-11e6-8a84-bae500000008",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "Причина",
"type": "string",
"value": "Черный"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "Коэффициент",
"type": "double",
"value": 0.4
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "Кек?",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2015-02-15 14:12:19",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "ae7fa9fb-3f74-11e6-8a84-bae500000070",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 13:23:26",
"name": "777",
"description": "Типичный заказ поставщику, с договором, другой валютой",
"code": "404",
"externalCode": "37KNBm7ф1gw7Zm00T5JdAt0",
"moment": "2016-12-05 15:30:14",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009/accounts/1485e43e-32ca-11e6-8a84-bae50000000a",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "Причина",
"type": "string",
"value": "Я всё ещё пишу для вас документацию"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "Коэффициент",
"type": "double",
"value": 0.99
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "Кек?",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2016-02-15 14:12:19",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0
}
]
Удалить Заказ поставщику
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа поставщику. |
Запрос на удаление Заказа поставщику с указанным id.
shell curl -X DELETE "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/7944ef04-f831-11e5-7a69-971500188b19" -H "Authorization: Basic <Access-Token>"Response 200 (application/json) Успешное удаление Заказа поставщику.
Метаданные Заказов Поставщикам
Метаданные Заказов Поставщикам
Запрос на получение метаданных Заказов поставщикам. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Заказов поставщикам + attributes - Массив объектов доп. полей Заказов поставщикам в формате Метаданных + states - Массив статусов Заказов поставщикам + createShared - создавать новые Заказы поставщикам с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Заказов Поставщикам
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Заказов поставщикам.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "Причина",
"type": "string",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "Коэффициент",
"type": "double",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "Кек?",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
},
"id": "11f5becd-3f70-11e6-8a84-bae50000008b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Кек",
"color": 10066329,
"stateType": "Regular",
"entityType": "purchaseorder"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "Коэффициент",
"type": "double",
"required": false
}
Шаблон заказа поставщику
Шаблон заказа поставщику
Запрос на получение предзаполненого стандартными значениями шаблона заказа поставщику без связи с каким-либо документом.
Шаблон заказа поставщику
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/new
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного заказа поставщику.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 17:33:33",
"applicable": true,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942953e-9128-11e6-8a84-bae500000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0
}
Шаблон заказа поставщику на основе
Запрос на получение предзаполненного шаблона заказа поставщику на основе внутреннего заказа или заказа покупателя. В ответ на запрос вернётся предзаполненный шаблон заказа поставщику, который затем можно будет использовать для создания нового заказа с помощью POST запроса.
Пример запроса на получение шаблона заказа поставщику на основе внутреннего заказа.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"internalOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного заказа поставщику.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 17:34:37",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 9910,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"rows": [
{
"quantity": 1,
"price": 2230,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 0
},
{
"quantity": 1,
"price": 100,
"discount": 10,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 0
},
{
"quantity": 2,
"price": 500,
"discount": 10,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 0
},
{
"quantity": 3,
"price": 2230,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 0
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"internalOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
}
Пример запроса на получение шаблона заказа поставщику на основе заказа покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"customerOrders": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/e9350b05-5751-11e8-9109-f8fc0010fba3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного заказа поставщику.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/8187b9ca-5751-11e8-9107-504800110aa3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/816f2c7e-5751-11e8-9109-f8fc0000534e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "",
"moment": "2018-05-14 11:39:50",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/819ac910-5751-11e8-9107-504800110ad2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 10000,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/819ab5e8-5751-11e8-9107-504800110acd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/81995e7d-5751-11e8-9107-504800110acb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"rows": [
{
"quantity": 20,
"price": 500,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/cbe0b7bc-5751-11e8-9ff4-31500010c0aa",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 0
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0,
"customerOrders": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/e9350b05-5751-11e8-9109-f8fc0010fba3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
]
}
Заказ поставщику
Получить Заказ поставщику
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа поставщику. |
Запрос на получение отдельного Заказа поставщику с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Заказа поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "172fb2f6-3f70-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 12:42:13",
"name": "00002",
"description": "Кековый заказ конечно",
"externalCode": "FfSmVuSKi7h8L-jLADHV80",
"moment": "2016-07-01 12:40:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 5900,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/14ae5431-32ca-11e6-8a84-bae50000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2016-07-15 12:40:00",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 5900
}
Изменить Заказ поставщику
Запрос на обновление Заказа поставщику с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Заказа поставщику, кроме тех, что
помечены Только для чтения в описании атрибутов Заказа поставщику.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа поставщику. |
Пример запроса на обновление отдельного Заказа поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"updated": "2016-07-01 13:15:05",
"name": "777",
"description": "Типичный заказ поставщику, с договором, другой валютой",
"code": "404",
"externalCode": "37KNBm7ф1gw7Zm00T5JdAt0",
"moment": "2016-12-05 15:30:14",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": null,
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"value": "Я всё ещё пишу для вас документацию"
},
{
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"value": 0.99
},
{
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": false,
"positions": [],
"deliveryPlannedMoment": "2016-02-15 14:12:19"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Заказа поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"id": "ae7fa9fb-3f74-11e6-8a84-bae500000070",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 13:23:26",
"name": "777",
"description": "Типичный заказ поставщику, с договором, другой валютой",
"code": "404",
"externalCode": "37KNBm7ф1gw7Zm00T5JdAt0",
"moment": "2016-12-05 15:30:14",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/states/11f5becd-3f70-11e6-8a84-bae50000008b",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009/accounts/1485e43e-32ca-11e6-8a84-bae50000000a",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a885b1b-3f70-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a885b1b-3f70-11e6-8a84-bae50000009d",
"name": "Причина",
"type": "string",
"value": "Я всё ещё пишу для вас документацию"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a88619c-3f70-11e6-8a84-bae50000009e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a88619c-3f70-11e6-8a84-bae50000009e",
"name": "Коэффициент",
"type": "double",
"value": 0.99
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata/attributes/6a886744-3f70-11e6-8a84-bae50000009f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6a886744-3f70-11e6-8a84-bae50000009f",
"name": "Кек?",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/ae7fa9fb-3f74-11e6-8a84-bae500000070/positions",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"deliveryPlannedMoment": "2016-02-15 14:12:19",
"payedSum": 0,
"shippedSum": 0,
"invoicedSum": 0,
"waitSum": 0
}
Позиции Заказа поставщику
Отдельный ресурс для управления позициями Заказа поставщику. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Заказа поставщику
Запрос на получение списка всех позиций данного Заказа поставщику. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Заказа поставщику.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа поставщику. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Заказа поставщику
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseOrder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного Заказа поставщику.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/",
"type": "purchaseorderposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/17307520-3f70-11e6-8a84-bae50000008f",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "17307520-3f70-11e6-8a84-bae50000008f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 4300,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0a89c6f1-3303-11e6-8a84-bae500000cda",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/17308a33-3f70-11e6-8a84-bae500000090",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "17308a33-3f70-11e6-8a84-bae500000090",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 600,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0163030c-3303-11e6-8a84-bae5000004de",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/17309bf8-3f70-11e6-8a84-bae500000091",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "17309bf8-3f70-11e6-8a84-bae500000091",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f918196-3304-11e6-8a84-bae50001c6d2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/1730ac60-3f70-11e6-8a84-bae500000092",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "1730ac60-3f70-11e6-8a84-bae500000092",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/1730bb31-3f70-11e6-8a84-bae500000093",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "1730bb31-3f70-11e6-8a84-bae500000093",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 1000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7b37adef-3303-11e6-8a84-bae50000bbf7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 1
}
]
}
Создать позицию Заказа поставщику
Запрос на создание новой позиции в Заказе поставщику. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Заказа + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа поставщику. |
Пример создания одной позиции в Заказе поставщику.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseOrder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 49,
"price": 451,
"discount": 0,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"shipped": 20,
"inTransit": 19
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного Заказа поставщику.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/574b6485-3f71-11e6-8a84-bae50000005b",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "574b6485-3f71-11e6-8a84-bae50000005b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 49,
"price": 451,
"discount": 0,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 19
}
]
Пример создания сразу нескольких позиций в Заказе поставщику.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseOrder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 12,
"price": 300,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"inTransit": 11
},
{
"quantity": 3,
"price": 1000,
"discount": 0,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"inTransit": 1
},
{
"quantity": 404,
"price": 454,
"discount": 200,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"inTransit": 216
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка созданных позиций отдельного Заказа поставщику.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/f389488d-3f71-11e6-8a84-bae50000005f",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "f389488d-3f71-11e6-8a84-bae50000005f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 12,
"price": 300,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 11
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/f389521b-3f71-11e6-8a84-bae500000060",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "f389521b-3f71-11e6-8a84-bae500000060",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 3,
"price": 1000,
"discount": 0,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/f3895aa1-3f71-11e6-8a84-bae500000061",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "f3895aa1-3f71-11e6-8a84-bae500000061",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 404,
"price": 454,
"discount": 200,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 216
}
]
Позиция Заказа
Отдельная позиция Заказа с указанным id позиции.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа поставщику. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа поставщику. |
Получить позицию Заказа
Запрос на получение отдельной позиции Заказа с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Заказа поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/1730bb31-3f70-11e6-8a84-bae500000093",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "1730bb31-3f70-11e6-8a84-bae500000093",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 1000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7b37adef-3303-11e6-8a84-bae50000bbf7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 1
}
Изменить позицию Заказа
Запрос на обновление отдельной позиции Заказа. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
|Параметр |Описание |
|---|---|
|id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа поставщику.|
|positionID| string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа поставщику.|
Пример запроса на обновление отдельной позиции в Заказе поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 44,
"price": 4540,
"discount": 150,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"shipped": 10,
"inTransit": 200
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Заказа поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/172fb2f6-3f70-11e6-8a84-bae50000008e/positions/f3895aa1-3f71-11e6-8a84-bae500000061",
"type": "purchaseorderposition",
"mediaType": "application/json"
},
"id": "f3895aa1-3f71-11e6-8a84-bae500000061",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 44,
"price": 4540,
"discount": 150,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"shipped": 0,
"inTransit": 200
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа поставщику. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа поставщику. |
Запрос на удаление отдельной позиции Заказа с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Заказа.
Документ Счёт покупателю
Счета покупателям
Средствами JSON API можно создавать и обновлять сведения о Счёте покупателю, запрашивать списки Счетов и сведения по отдельным Счетам Покупателям. Позициями Счетов можно управлять как в составе отдельного Счёта, так и отдельно - с помощью специальных ресурсов для управления позициями Счёта. Кодом сущности для Счёта покупателю в составе JSON API является ключевое слово invoiceout. Больше о Счетах Покупателям и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Атрибуты сущности
- meta - Метаданные о Счёте покупателю
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Счёта покупателю
- description - Комментарий Счёта покупателю
- externalCode - Внешний код Счёта покупателю
- moment - Дата Счёта
- applicable - Отметка о проведении
- vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- sum - Сумма Счёта в установленной валюте
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
- contract - Ссылка на договор в формате Метаданных
- state - Статус Счёта в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения - positions - Ссылка на позиции в Счёте в формате Метаданных
- paymentPlannedMoment - Планируемая дата оплаты
- payedSum - Сумма входящих платежей по Счёту покупателю
Только для чтения - shippedSum - Сумма отгруженного
Только для чтения - project - Ссылка на проект в формате Метаданных #### Связи с другими документами
- customerOrder - Ссылка на Заказ Покупателя, с которым связан этот Счёт покупателю в формате Метаданных
- payments - Массив ссылок на связанные операции в формате Метаданных
Только для чтения - demands - Массив ссылок на связанные отгрузки в формате Метаданных
Позиции Счёта покупателю
Позиции Счёта - это список товаров/услуг/модификаций/серий.
Объект позиции Счёта содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ discount - Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10%
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
С позициями можно работать с помощью специальных ресурсов для управления позициями Счёта, а также в составе отдельного Счёта покупателю. При работе в составе отдельного Счёта покупателю, вы можете отправлять запросы на создание отдельного Счёта покупателю с включенным в тело запроса массивом позиций Счёта. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Счёта покупателю". Также, при работе в составе отдельного Счёта покупателю, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Счёта. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Счёта" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Счетов покупателям можно прочитать здесь
Получить Счета покупателям
Запрос всех Счетов покупателям на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Счета покупателям.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить Счета покупателям
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Счетов покупателям.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/0cb8d047-f664-11e5-8a84-bae500000095",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "0cb8d047-f664-11e5-8a84-bae500000095",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-03-30 16:48:13",
"name": "00001",
"externalCode": "TAXyoccKiJPtMhcBAsqqw1",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-03-30 13:41:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 123000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/0cb8d047-f664-11e5-8a84-bae500000095/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 6,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/2ee1ce22-019e-11e6-9464-e4de0000007d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "2ee1ce22-019e-11e6-9464-e4de0000007d",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-22 15:00:07",
"name": "13212",
"externalCode": "Vv-7tagmi46o0TTT6XI1a0",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-14 11:02:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 408739611676,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/2ee1ce22-019e-11e6-9464-e4de0000007d/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"paymentPlannedMoment": "2016-04-15 11:03:00",
"payedSum": 0,
"shippedSum": 0,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/8a7a037d-0564-11e6-9464-e4de000000a2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "8a7a037d-0564-11e6-9464-e4de000000a2",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-18 15:53:25",
"name": "13213",
"externalCode": "lLXQLQQrg2s1Q6j8vVt7g2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-18 15:53:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/51f263f9-0307-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/8a7a037d-0564-11e6-9464-e4de000000a2/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"paymentPlannedMoment": "2016-04-09 15:53:00",
"payedSum": 0,
"shippedSum": 0
}
]
}
Создать Счёт покупателю
Запрос на создание нового Счёта покупателю. Обязательные для создания поля: + name - номер Счёта покупателю + organization - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на контрагента (покупателя) в формате Метаданных
Пример создания нового Счёта с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "inv_out_name",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/726e5b8c-0886-11e6-9464-e4de0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "726e5b8c-0886-11e6-9464-e4de0000002a",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-22 16:02:47",
"name": "inv_out_name",
"externalCode": "BtPDebO1g1PlmStW1jr--2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-22 16:02:47",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/726e5b8c-0886-11e6-9464-e4de0000002a/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
Пример создания нового Счёта с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "inv_out_name",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"code": "1243521",
"externalCode": "666777666",
"moment": "2016-04-19 13:50:24",
"applicable": true,
"description": "Описание счёта",
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/128465fd-0887-11e6-9464-e4de0000002e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "128465fd-0887-11e6-9464-e4de0000002e",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-22 16:07:16",
"name": "inv_out_name",
"description": "Описание счёта",
"code": "1243521",
"externalCode": "666777666",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/128465fd-0887-11e6-9464-e4de0000002e/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
Пример запроса на создание Счёта покупателю с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "inv_out_name",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"code": "1243521",
"externalCode": "666777666",
"moment": "2016-04-19 13:50:24",
"applicable": true,
"description": "Комментарий к счёту",
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "51d191f4-0887-11e6-9464-e4de00000079",
"value": "значение доп поля"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/c358e3ac-0887-11e6-9464-e4de00000032",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "c358e3ac-0887-11e6-9464-e4de00000032",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-22 16:12:12",
"name": "inv_out_name2",
"description": "Комментарий к счёту",
"code": "124352133",
"externalCode": "666777666",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "51d191f4-0887-11e6-9464-e4de00000079",
"name": "Атрибут счёта",
"type": "string",
"value": "значение доп поля"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/c358e3ac-0887-11e6-9464-e4de00000032/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
Пример запроса на создание Счёта покупателю с позициями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "inv_out_name3",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"code": "12435213322",
"externalCode": "666777666",
"moment": "2016-04-19 13:50:24",
"applicable": true,
"description": "Комментарий к счёту",
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "6afee657-0888-11e6-9464-e4de00000037",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-22 16:16:54",
"name": "inv_out_name3",
"description": "Комментарий к счёту",
"code": "12435213322",
"externalCode": "666777666",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 5840,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
Массовое создание и обновление Счётов покупателю
Массовое создание и обновление Счётов покупателю. В теле запроса нужно передать массив, содержащий JSON представления Счётов покупателю, которые вы хотите создать или обновить. Обновляемые Счёта покупателю должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Счётов покупателю
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "inv_out_name",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"name": "change name",
"code": "change_code",
"externalCode": "666777666",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"description": "Комментарий к счёту",
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Счётов покупателю.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/726e5b8c-0886-11e6-9464-e4de0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "726e5b8c-0886-11e6-9464-e4de0000002a",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-22 16:02:47",
"name": "inv_out_name",
"externalCode": "BtPDebO1g1PlmStW1jr--2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-22 16:02:47",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/726e5b8c-0886-11e6-9464-e4de0000002a/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "6afee657-0888-11e6-9464-e4de00000037",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-22 16:21:19",
"name": "change name",
"description": "Комментарий к счёту",
"code": "change_code",
"externalCode": "666777666",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 5840,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
]
Удалить Счёт покупателю
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта покупателю. |
Запрос на удаление Счёта покупателю с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Счёта покупателю.
Метаданные Счетов покупателям
Метаданные Счетов покупателям
Запрос на получение метаданных Счетов покупателям. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Счетов покупателям + attributes - Массив объектов доп. полей Счетов покупателям в формате Метаданных + states - Массив статусов Счетов покупателям + createShared - создавать новые Счета покупателям с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Счетов покупателям
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Счетов покупателям.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata/attributes/51d191f4-0887-11e6-9464-e4de00000079",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "51d191f4-0887-11e6-9464-e4de00000079",
"name": "Атрибут счёта",
"type": "string",
"required": false
}
],
"createShared": false
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata/attributes/d91965f1-558b-11e6-8a84-bae500000087",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d91965f1-558b-11e6-8a84-bae500000087",
"name": "Процент прибыли",
"type": "double",
"required": false
}
Шаблон счёта покупателю
Шаблон счёта покупателю
Запрос на получение предзаполненого стандартными значениями шаблона счёта покупателю без связи с каким-либо документом.
Пустое тело запроса (application/json)
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного счёта покупателю.
{
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
},
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"shippedSum": 0
}
Шаблон счёта покупателю на основе
Запрос на получение предзаполненного счёта покупателю на основе заказа покупателя или отгрузки. В результате запроса, будет создан предзаполненный шаблон счёта покупателю на основе переданного документа.
Запрос на создание счёта покупателю на основе заказа покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/451cb4c0-3d1d-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного счёта покупателю.
{
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/6792c8d5-3d19-11e6-8a84-bae500000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
},
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"shippedSum": 0,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/451cb4c0-3d1d-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
}
Запрос на создание счёта покупателю на основе отгрузки.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/94e39314-cba5-11e7-6a80-332a00000035",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#demand/edit?id=94e39314-cba5-11e7-6a80-332a00000035"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного счёта покупателю.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/46073d61-ca1f-11e7-6a80-332a0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=46073d61-ca1f-11e7-6a80-332a0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/452fb22f-ca1f-11e7-6a80-332a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "",
"moment": "2017-11-22 19:08:56",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/464062ac-ca1f-11e7-6a80-332a00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=464062ac-ca1f-11e7-6a80-332a00000058"
}
}
},
"sum": 90000,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/463f8970-ca1f-11e7-6a80-332a00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=463f8970-ca1f-11e7-6a80-332a00000053"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/463fe231-ca1f-11e7-6a80-332a00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=463fe231-ca1f-11e7-6a80-332a00000056"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/463a706e-ca1f-11e7-6a80-332a00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=463a706e-ca1f-11e7-6a80-332a00000051"
}
},
"documents": {
"rows": []
},
"positions": {
"rows": [
{
"quantity": 1,
"price": 90000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/b5d328b3-cab0-11e7-6a80-332a0000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"shippedSum": 0,
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/94e39314-cba5-11e7-6a80-332a00000035",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#demand/edit?id=94e39314-cba5-11e7-6a80-332a00000035"
}
}
]
}
Счёт покупателю
Получить Счёт покупателю
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта покупателя. |
Запрос на получение отдельного Счёта покупателю с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/0cb8d047-f664-11e5-8a84-bae500000095",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "0cb8d047-f664-11e5-8a84-bae500000095",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-03-30 16:48:13",
"name": "00001",
"externalCode": "TAXyoccKiJPtMhcBAsqqw1",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-03-30 13:41:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 123000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/0cb8d047-f664-11e5-8a84-bae500000095/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 6,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
Изменить Счёт покупателю
Запрос на обновление Счета покупателю с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Счёта покупателю, кроме тех, что
помечены Только для чтения в описании атрибутов Счёта покупателю.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта покупателя. |
Пример запроса на обновление отдельного Счёта покупателю.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "change name",
"code": "change_code",
"externalCode": "666777666",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"description": "Комментарий к счёту",
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "6afee657-0888-11e6-9464-e4de00000037",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-22 16:21:19",
"name": "change name",
"description": "Комментарий к счёту",
"code": "change_code",
"externalCode": "666777666",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 5840,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
Пример запроса на изменение Счёта покупателю с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "change name",
"code": "change_code",
"externalCode": "666777666",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"description": "Комментарий к счёту",
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "51d191f4-0887-11e6-9464-e4de00000079",
"value": "new_val"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "6afee657-0888-11e6-9464-e4de00000037",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-22 16:21:19",
"name": "change name",
"description": "Комментарий к счёту",
"code": "change_code",
"externalCode": "666777666",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 5840,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "51d191f4-0887-11e6-9464-e4de00000079",
"name": "Атрибут счёта",
"type": "string",
"value": "new_val"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
Пример запроса на обновление Счёта покупателю с позициями в теле запроса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "change name again",
"code": "change_code_again",
"externalCode": "666777666",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"description": "Now with 1 position",
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "51d191f4-0887-11e6-9464-e4de00000079",
"value": "new_val_again"
}
],
"positions": [
{
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"id": "6afee657-0888-11e6-9464-e4de00000037",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-22 16:25:06",
"name": "change name again",
"description": "Now with 1 position",
"code": "change_code_again",
"externalCode": "666777666",
"owner": {
"name": "Администратор"
},
"shared": false,
"group": {
"name": "Основной"
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/account/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "51d191f4-0887-11e6-9464-e4de00000079",
"name": "Атрибут счёта",
"type": "string",
"value": "new_val_again"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
Позиции Счёта покупателю
Отдельный ресурс для управления позициями Счёта покупателю. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Счёта покупателю
Запрос на получение списка всех позиций данного Счёта покупателю. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Счёта покупателю.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта покупателя. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Счёта покупателю
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного Счёта покупателю.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions/90572e91-0889-11e6-9464-e4de00000043",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "90572e91-0889-11e6-9464-e4de00000043",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
Добавить позицию в Счёт покупателя
Запрос на создание новой позиции в Счёте покупателю. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Счёта + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Также, как и при работе с Позициями Заказа Покупателя, можно создать как одну, так и несколько позиций в одном запросе.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта покупателя. |
Пример создания позиции в Счёте покупателю.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 12,
"price": 999,
"discount": 1,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/671402e4-f7d2-11e5-8a84-bae50000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного Счёте покупателю.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions/8a43c5a3-088a-11e6-9464-e4de00000046",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "8a43c5a3-088a-11e6-9464-e4de00000046",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 12,
"price": 999,
"discount": 1,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/671402e4-f7d2-11e5-8a84-bae50000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
Позиция Счёта покупателя
Отдельная позиция Счёта покупателю с указанным id позиции.
Получить позицию Счёта
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта покупателя. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id id позиции Счёта покупателю. |
Запрос на получение отдельной позиции Счёта с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions/8a43c5a3-088a-11e6-9464-e4de00000046",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "8a43c5a3-088a-11e6-9464-e4de00000046",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 12,
"price": 999,
"discount": 1,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/671402e4-f7d2-11e5-8a84-bae50000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
Изменить позицию Счёта
Запрос на обновление отдельной позиции Счёта. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта покупателя. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id id позиции Счёта покупателю. |
Пример запроса на обновление отдельной позиции в Счёте покупателю.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 22,
"price": 1000,
"discount": 0,
"vat": 12
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Счёта покупателю.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6afee657-0888-11e6-9464-e4de00000037/positions/8a43c5a3-088a-11e6-9464-e4de00000046",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "8a43c5a3-088a-11e6-9464-e4de00000046",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 22,
"price": 1000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/671402e4-f7d2-11e5-8a84-bae50000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта покупателя. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id id позиции Счёта покупателю. |
Запрос на удаление отдельной позиции Счёта с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Счёта.
Документ Счёт поставщика
Счета поставщиков
Средствами JSON API можно создавать и обновлять сведения о Счёте поставщика, запрашивать списки Счетов и сведения по отдельным Счетам Поставщиков. Позициями Счетов можно управлять как в составе отдельного Счёта, так и отдельно - с помощью специальных ресурсов для управления позициями Счёта. Кодом сущности для Счёта поставщика в составе JSON API является ключевое слово invoicein. Больше о Счетах Поставщиков и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Атрибуты сущности
- meta - Метаданные о Счёте поставщика
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Счёта поставщика
- description - Комментарий Счёта поставщика
- externalCode - Внешний код Счёта поставщика
- moment - Дата Счёта
- applicable - Отметка о проведении
- vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- sum - Сумма Счёта в установленной валюте
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
- contract - Ссылка на договор в формате Метаданных
- state - Статус Счёта в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения - positions - Ссылка на позиции в Счёте в формате Метаданных
- paymentPlannedMoment - Планируемая дата оплаты
- payedSum - Сумма входящих платежей по Счёту поставщика
Только для чтения - shippedSum - Сумма отгруженного
Только для чтения - project - Ссылка на проект в формате Метаданных
- incomingNumber - Входящий номер
- incomingDate - Входящая дата #### Связи с другими документами
- payments - Массив ссылок на связанные операции в формате Метаданных
Только для чтения - purchaseOrder - Ссылка на связанный заказ поставщику в формате Метаданных
- supplies - Ссылки на связанные приёмки в формате Метаданных
Позиции Счёта поставщика
Позиции Счёта - это список товаров/услуг/модификаций/серий.
Объект позиции Счёта содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ discount - Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10%
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
С позициями можно работать с помощью специальных ресурсов для управления позициями Счёта, а также в составе отдельного Счёта поставщика. При работе в составе отдельного Счёта поставщика, вы можете отправлять запросы на создание отдельного Счёта поставщика с включенным в тело запроса массивом позиций Счёта. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Счёта поставщика". Также, при работе в составе отдельного Счёта поставщика, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Счёта. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Счёта" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Счетов поставщиков можно прочитать здесь
Получить Счета поставщиков
Запрос всех Счетов поставщиков на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Счета поставщиков.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить Счета поставщиков
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Счетов поставщиков.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/af6f9b4c-2e64-11e6-8a84-bae500000149",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "af6f9b4c-2e64-11e6-8a84-bae500000149",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-10 17:04:15",
"name": "00001",
"externalCode": "tGOteo8phk7xjWaYInNdo3",
"moment": "2016-06-10 10:16:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf41a7b-2e58-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/af6f9b4c-2e64-11e6-8a84-bae500000149/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "36c000ad-3f52-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:08:21",
"name": "00002",
"externalCode": "oS8jXsK8hHmxYzn8MzT1d0",
"moment": "2016-07-01 09:07:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/2b34d43f-3f52-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d/accounts/1489ad8d-32ca-11e6-8a84-bae50000000e",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"paymentPlannedMoment": "2016-07-07 09:07:00",
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "124124",
"incomingDate": "2016-07-28 00:00:00"
}
]
}
Создать Счёт поставщика
Запрос на создание нового Счёта поставщика. Обязательные для создания поля: + name - номер Счёта поставщика + organization - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на контрагента (поставщика) в формате Метаданных
Пример создания нового Счёта с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "007232",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/06fdb416-3f55-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "06fdb416-3f55-11e6-8a84-bae500000007",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:28:30",
"name": "007232",
"externalCode": "zpLXS2--gsfaXr1VEn8Xv1",
"moment": "2016-07-01 09:28:30",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/06fdb416-3f55-11e6-8a84-bae500000007/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
}
Пример создания нового Счёта с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "00732",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"code": "77881123",
"externalCode": "33443",
"moment": "2016-06-27 10:52:24",
"applicable": true,
"description": "Счёт поставщика",
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"incomingNumber": "12412412",
"incomingDate": "2016-06-17 10:52:24"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/6d4d1628-3f54-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "6d4d1628-3f54-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:24:12",
"name": "00732",
"description": "Счёт поставщика",
"code": "77881123",
"externalCode": "33443",
"moment": "2016-06-27 10:52:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/6d4d1628-3f54-11e6-8a84-bae500000000/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "12412412",
"incomingDate": "2016-06-17 10:52:24"
}
Пример запроса на создание Счёта поставщика с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "5500732",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"code": "77881123",
"externalCode": "33443",
"moment": "2016-06-27 10:52:24",
"applicable": true,
"description": "Счёт поставщика",
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"incomingNumber": "12412412",
"incomingDate": "2016-06-17 10:52:24",
"attributes": [
{
"id": "e97c5ea8-3f52-11e6-8a84-bae50000006f",
"value": 5
},
{
"id": "48c7b9af-3f55-11e6-8a84-bae500000076",
"value": true
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/ab4486eb-3f55-11e6-8a84-bae50000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "ab4486eb-3f55-11e6-8a84-bae50000000b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:33:05",
"name": "5500732",
"description": "Счёт поставщика",
"code": "77881123",
"externalCode": "33443",
"moment": "2016-06-27 10:52:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata/attributes/e97c5ea8-3f52-11e6-8a84-bae50000006f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "e97c5ea8-3f52-11e6-8a84-bae50000006f",
"name": "Карма",
"type": "long",
"value": 5
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata/attributes/48c7b9af-3f55-11e6-8a84-bae500000076",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "48c7b9af-3f55-11e6-8a84-bae500000076",
"name": "По акции",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/ab4486eb-3f55-11e6-8a84-bae50000000b/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "12412412",
"incomingDate": "2016-06-17 10:52:24"
}
Пример запроса на создание Счёта поставщика с позициями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "69375",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"code": "77881123",
"externalCode": "33443",
"moment": "2016-06-27 10:52:24",
"applicable": true,
"description": "Счёт поставщика",
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"incomingNumber": "12412412",
"incomingDate": "2016-06-17 10:52:24",
"positions": [
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00f1f397-3303-11e6-8a84-bae500000380",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00dacbec-3303-11e6-8a84-bae50000033a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e84aed23-3303-11e6-8a84-bae500014dcd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 263000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "13607115-3f56-11e6-8a84-bae500000011",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:36:00",
"name": "69375",
"description": "Счёт поставщика",
"code": "77881123",
"externalCode": "33443",
"moment": "2016-06-27 10:52:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 263000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "12412412",
"incomingDate": "2016-06-17 10:52:24"
}
Массовое создание и обновление Счётов поставщика
Массовое создание и обновление Счётов поставщика. В теле запроса нужно передать массив, содержащий JSON представления Счётов поставщика, которые вы хотите создать или обновить. Обновляемые Счёта поставщика должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Счётов поставщика
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "007232",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"name": "4040228",
"description": "Сделка с новым поставщиком",
"code": "1234124152",
"externalCode": "8756248",
"moment": "2016-06-29 10:59:24",
"applicable": false,
"sum": 125712521,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f/accounts/149ba387-32ca-11e6-8a84-bae500000020",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": false,
"positions": [],
"payedSum": 700,
"shippedSum": 1230,
"incomingNumber": "66355",
"incomingDate": "2016-12-05 11:42:54"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Счётов поставщика.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/06fdb416-3f55-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "06fdb416-3f55-11e6-8a84-bae500000007",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:28:30",
"name": "007232",
"externalCode": "zpLXS2--gsfaXr1VEn8Xv1",
"moment": "2016-07-01 09:28:30",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/06fdb416-3f55-11e6-8a84-bae500000007/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "13607115-3f56-11e6-8a84-bae500000011",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:42:42",
"name": "4040228",
"description": "Сделка с новым поставщиком",
"code": "1234124152",
"externalCode": "8756248",
"moment": "2016-06-29 10:59:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f/accounts/149ba387-32ca-11e6-8a84-bae500000020",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "66355",
"incomingDate": "2016-12-05 11:42:54"
}
]
Удалить Счёт поставщика
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта поставщика. |
Запрос на удаление Счёта поставщика с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Счёта поставщика.
Метаданные Счетов поставщиков
Метаданные Счетов поставщиков
Запрос на получение метаданных Счетов поставщиков. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Счетов поставщиков + attributes - Массив объектов доп. полей Счетов поставщиков в формате Метаданных + states - Массив статусов Счетов поставщиков + createShared - создавать новые Счета поставщиков с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Счетов поставщиков
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Счетов поставщиков.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata/attributes/e97c5ea8-3f52-11e6-8a84-bae50000006f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "e97c5ea8-3f52-11e6-8a84-bae50000006f",
"name": "Карма",
"type": "long",
"required": false
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata/attributes/48c7b9af-3f55-11e6-8a84-bae500000076",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "48c7b9af-3f55-11e6-8a84-bae500000076",
"name": "По акции",
"type": "boolean",
"required": false
}
Шаблон счёта поставщика
Шаблон счёта поставщика
Запрос на получение предзаполненого стандартными значениями шаблона счёта поставщика без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного счёта поставщика.
{
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
},
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"shippedSum": 0
}
Шаблон счёта поставщика на основе
Запрос на получение предзаполненного счёта поставщика на основе заказа поставщику или приёмки. В результате запроса, будет создан предзаполненный шаблон счёта поставщика на основе переданного документа.
Запрос на создание счёта поставщика на основе заказа поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"purchaseOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного счёта поставщика.
{
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e105a2e7-3f6f-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1483952f-32ca-11e6-8a84-bae500000007/accounts/1483a4fa-32ca-11e6-8a84-bae500000008",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"type": "invoiceposition",
"mediaType": "application/json"
},
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"shippedSum": 0,
"purchaseOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
}
}
}
Запрос на создание счёта поставщика на основе приемки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/60c7896d-cf7c-11e7-6a80-332a00000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#supply/edit?id=60c7896d-cf7c-11e7-6a80-332a00000004"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного счёта поставщика.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/46073d61-ca1f-11e7-6a80-332a0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=46073d61-ca1f-11e7-6a80-332a0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/452fb22f-ca1f-11e7-6a80-332a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "",
"moment": "2017-11-22 19:08:01",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/464062ac-ca1f-11e7-6a80-332a00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=464062ac-ca1f-11e7-6a80-332a00000058"
}
}
},
"sum": 100000,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/463f8970-ca1f-11e7-6a80-332a00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=463f8970-ca1f-11e7-6a80-332a00000053"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/463fb76d-ca1f-11e7-6a80-332a00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=463fb76d-ca1f-11e7-6a80-332a00000054"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/463a706e-ca1f-11e7-6a80-332a00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=463a706e-ca1f-11e7-6a80-332a00000051"
}
},
"documents": {
"rows": []
},
"positions": {
"rows": [
{
"quantity": 1,
"price": 100000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/b5d328b3-cab0-11e7-6a80-332a0000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"shippedSum": 0,
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/60c7896d-cf7c-11e7-6a80-332a00000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#supply/edit?id=60c7896d-cf7c-11e7-6a80-332a00000004"
}
}
]
}
Счёт поставщика
Получить Счёт поставщика
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта поставщика. |
Запрос на получение отдельного Счёта поставщика с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "36c000ad-3f52-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:08:21",
"name": "00002",
"externalCode": "oS8jXsK8hHmxYzn8MzT1d0",
"moment": "2016-07-01 09:07:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/2b34d43f-3f52-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d/accounts/1489ad8d-32ca-11e6-8a84-bae50000000e",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"paymentPlannedMoment": "2016-07-07 09:07:00",
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "124124",
"incomingDate": "2016-07-28 00:00:00"
}
Изменить Счёт поставщика
Запрос на обновление Счета поставщика с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Счёта поставщика, кроме тех, что
помечены Только для чтения в описании атрибутов Счёта поставщика.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта поставщика. |
Пример запроса на обновление отдельного Счёта поставщика.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "4040228",
"description": "Сделка с новым поставщиком",
"code": "1234124152",
"externalCode": "8756248",
"moment": "2016-06-29 10:59:24",
"applicable": false,
"sum": 125712521,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f/accounts/149ba387-32ca-11e6-8a84-bae500000020",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": false,
"positions": [],
"payedSum": 700,
"shippedSum": 1230,
"incomingNumber": "66355",
"incomingDate": "2016-12-05 11:42:54"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "13607115-3f56-11e6-8a84-bae500000011",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:42:42",
"name": "4040228",
"description": "Сделка с новым поставщиком",
"code": "1234124152",
"externalCode": "8756248",
"moment": "2016-06-29 10:59:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f/accounts/149ba387-32ca-11e6-8a84-bae500000020",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "66355",
"incomingDate": "2016-12-05 11:42:54"
}
Пример запроса на изменение Счёта поставщика с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "4040228",
"description": "Сделка с новым поставщиком",
"code": "1234124152",
"externalCode": "8756248",
"moment": "2016-06-29 10:59:24",
"applicable": false,
"sum": 125712521,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f/accounts/149ba387-32ca-11e6-8a84-bae500000020",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": false,
"positions": [],
"attributes": [
{
"id": "e97c5ea8-3f52-11e6-8a84-bae50000006f",
"value": 1
},
{
"id": "48c7b9af-3f55-11e6-8a84-bae500000076",
"value": false
}
],
"payedSum": 700,
"shippedSum": 1230,
"incomingNumber": "66355",
"incomingDate": "2016-12-05 11:42:54"
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "13607115-3f56-11e6-8a84-bae500000011",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:42:42",
"name": "4040228",
"description": "Сделка с новым поставщиком",
"code": "1234124152",
"externalCode": "8756248",
"moment": "2016-06-29 10:59:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f/accounts/149ba387-32ca-11e6-8a84-bae500000020",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata/attributes/e97c5ea8-3f52-11e6-8a84-bae50000006f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "e97c5ea8-3f52-11e6-8a84-bae50000006f",
"name": "Карма",
"type": "long",
"value": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata/attributes/48c7b9af-3f55-11e6-8a84-bae500000076",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "48c7b9af-3f55-11e6-8a84-bae500000076",
"name": "По акции",
"type": "boolean",
"value": false
}
],
"vatEnabled": true,
"vatIncluded": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "66355",
"incomingDate": "2016-12-05 11:42:54"
}
Пример запроса на обновление Счёта поставщика с позициями в теле запроса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "4040228",
"description": "Сделка с новым поставщиком",
"code": "1234124152",
"externalCode": "8756248",
"moment": "2016-06-29 10:59:24",
"applicable": false,
"sum": 125712521,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f/accounts/149ba387-32ca-11e6-8a84-bae500000020",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": false,
"positions": [
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00f1f397-3303-11e6-8a84-bae500000380",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00dacbec-3303-11e6-8a84-bae50000033a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"attributes": [
{
"id": "e97c5ea8-3f52-11e6-8a84-bae50000006f",
"value": 1
},
{
"id": "48c7b9af-3f55-11e6-8a84-bae500000076",
"value": false
}
],
"payedSum": 700,
"shippedSum": 1230,
"incomingNumber": "66355",
"incomingDate": "2016-12-05 11:42:54"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"id": "13607115-3f56-11e6-8a84-bae500000011",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 09:44:23",
"name": "4040228",
"description": "Сделка с новым поставщиком",
"code": "1234124152",
"externalCode": "8756248",
"moment": "2016-06-29 10:59:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/149b96ba-32ca-11e6-8a84-bae50000001f/accounts/149ba387-32ca-11e6-8a84-bae500000020",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata/attributes/e97c5ea8-3f52-11e6-8a84-bae50000006f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "e97c5ea8-3f52-11e6-8a84-bae50000006f",
"name": "Карма",
"type": "long",
"value": 1
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata/attributes/48c7b9af-3f55-11e6-8a84-bae500000076",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "48c7b9af-3f55-11e6-8a84-bae500000076",
"name": "По акции",
"type": "boolean",
"value": false
}
],
"vatEnabled": true,
"vatIncluded": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"shippedSum": 0,
"incomingNumber": "66355",
"incomingDate": "2016-12-05 11:42:54"
}
Позиции Счёта поставщика
Отдельный ресурс для управления позициями Счёта поставщика. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Счёта поставщика
Запрос на получение списка всех позиций данного Счёта поставщика. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Счёта поставщика.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта поставщика. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Счёта поставщика
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного Счёта поставщика.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069/positions",
"type": "invoiceposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069/positions/36c018f9-3f52-11e6-8a84-bae50000006a",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "36c018f9-3f52-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00f1f397-3303-11e6-8a84-bae500000380",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069/positions/36c021a2-3f52-11e6-8a84-bae50000006b",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "36c021a2-3f52-11e6-8a84-bae50000006b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00dacbec-3303-11e6-8a84-bae50000033a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069/positions/1ab34547-3f53-11e6-8a84-bae500000072",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "1ab34547-3f53-11e6-8a84-bae500000072",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e84aed23-3303-11e6-8a84-bae500014dcd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069/positions/1ab353de-3f53-11e6-8a84-bae500000073",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "1ab353de-3f53-11e6-8a84-bae500000073",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 263000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
Добавить позицию в Счёт поставщика
Запрос на создание новой позиции в Счёте поставщика. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Счёта + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта поставщика. |
Пример создания позиции в Счёте поставщика.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 12,
"price": 999,
"discount": 1,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного Счёте поставщика.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/6d4d1628-3f54-11e6-8a84-bae500000000/positions/c3b264eb-3f54-11e6-8a84-bae500000004",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "c3b264eb-3f54-11e6-8a84-bae500000004",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 12,
"price": 999,
"discount": 1,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
Позиция Счёта поставщика
Отдельная позиция Счёта поставщика с указанным id позиции.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта поставщика. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Счёта поставщика. |
Получить позицию Счёта
Запрос на получение отдельной позиции Счёта с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/36c000ad-3f52-11e6-8a84-bae500000069/positions/36c018f9-3f52-11e6-8a84-bae50000006a",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "36c018f9-3f52-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/00f1f397-3303-11e6-8a84-bae500000380",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Изменить позицию Счёта
Запрос на обновление отдельной позиции Счёта. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта поставщика. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Счёта поставщика. |
Пример запроса на обновление отдельной позиции в Счёте поставщика.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 47,
"price": 303,
"discount": 0,
"vat": 11,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Счёта поставщика.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/13607115-3f56-11e6-8a84-bae500000011/positions/13607a10-3f56-11e6-8a84-bae500000012",
"type": "invoiceposition",
"mediaType": "application/json"
},
"id": "13607a10-3f56-11e6-8a84-bae500000012",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 47,
"price": 303,
"discount": 0,
"vat": 11,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счёта поставщика. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Счёта поставщика. |
Запрос на удаление отдельной позиции Счёта с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/invoicein/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Счёта.
Документ Входящий платеж
Входящие платежи
Средствами JSON API можно создавать и обновлять сведения о платеже , запрашивать списки Входящих платежей и сведения по отдельным Входящим платежам. Кодом сущности для Входящего платежа в составе JSON API является ключевое слово paymentin. Больше о платежах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Атрибуты сущности
- meta - Метаданные о платеже
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Входящего платежа
- description - Комментарий Входящего платежа
- externalCode - Внешний код Входящего платежа
- moment - Дата Входящего платежа
- applicable - Отметка о проведении
- sum - Сумма Входящего платежа в установленной валюте
- project - Ссылка на проект в формате Метаданных
- rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента или юрлицо в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- state - Статус Входящего платежа в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - paymentPurpose - Назначение платежа
- vatSum - Сумма включая НДС
- incomingDate - Входящая дата
- incomingNumber - Входящий номер
Связи с другими документами
- factureOut - Ссылка на Счет-фактура выданный, с которым связан этот платеж в формате Метаданных
- operations - Массив ссылок на связанные операции в формате Метаданных
- meta - Ссылка на операцию, к которой привязан этот платёж в формате метаданных
- linkedSum - Сумма, оплаченная по данному документу из этого платежа
Разрешенные типы связанных операций: + Заказ покупателя (customerorder) + Возврат поставщику (purchasereturn) + Отгрузка (demand) + Счёт покупателю (invoiceout) + Полученный отчёт комиссионера (commissionreportin) + Смена (retailShift)
О работе с доп. полями Входящих платежей можно прочитать здесь
Получить Входящие платежи
Запрос всех Входящих платежей на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Входящие платежи.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить Входящие платежи
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Входящих платежей.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/ad1ffc02-3f8e-11e6-8a84-bae5000000fa",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"id": "ad1ffc02-3f8e-11e6-8a84-bae5000000fa",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 16:21:10",
"name": "00001",
"description": "Платёж за красивые глаза",
"externalCode": "8hBoVBUMiDeumkozzjwX83",
"moment": "2016-07-01 16:19:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 124124100,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/2b34d43f-3f52-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/states/ab8f5213-3f8e-11e6-8a84-bae5000000f5",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d/accounts/1489ad8d-32ca-11e6-8a84-bae50000000e",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "За красивые глаза",
"incomingNumber": "12412569",
"incomingDate": "2016-07-22 00:00:00",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/90ba347d-6b8b-11e6-8a84-bae5000000bd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
},
"linkedSum": 80000
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/d57389cb-3d3e-11e6-8a84-bae500000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"id": "d57389cb-3d3e-11e6-8a84-bae500000001",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-28 17:44:35",
"name": "00001",
"externalCode": "221dSpiQiVQuVfCbRun623",
"moment": "2015-06-22 00:00:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 440000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/c4a418a7-3d2d-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/c4a418a7-3d2d-11e6-8a84-bae500000003/accounts/c4a423fd-3d2d-11e6-8a84-bae500000004",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по счету №19111167 от 19.06.2015 за предоставление услуги \"МойСклад\" по договору оферты на сайте www.moysklad.ru/subscription В том числе НДС (18%), 671.29 руб.",
"incomingNumber": "408",
"incomingDate": "2015-06-19 00:00:00",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/90ba347d-6b8b-11e6-8a84-bae5000000bd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
},
"linkedSum": 80000
}
]
}
]
}
Создать Входящий платеж
Запрос на создание нового Входящего платежа. Обязательные для создания поля: + name - номер Входящего платежа + organization - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на контрагента в формате Метаданных
Пример создания нового Входящего платежа с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "333222",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Входящего платежа.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/85cf9c48-3f92-11e6-8a84-bae500000096",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"id": "85cf9c48-3f92-11e6-8a84-bae500000096",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 16:48:42",
"name": "333222",
"moment": "2016-06-27 17:52:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
}
}
Массовое создание и обновление Входящих платежей
Массовое создание и обновление Входящих платежей. В теле запроса нужно передать массив, содержащий JSON представления Входящих платежей, которые вы хотите создать или обновить. Обновляемые Входящие платежи должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Входящих платежей
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "333222",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/85cf9c48-3f92-11e6-8a84-bae500000096",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"name": "333444",
"description": "Не совсем Новый Входящий платёж",
"code": "101010001",
"externalCode": "2213sfkksbajf214812slkanf",
"moment": "2012-06-27 17:52:24",
"applicable": true,
"sum": 40020,
"incomingNumber": "3",
"incomingDate": "2016-03-17 10:52:24"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Входящих платежей.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/85cf9c48-3f92-11e6-8a84-bae500000096",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"id": "85cf9c48-3f92-11e6-8a84-bae500000096",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 16:48:42",
"name": "333222",
"moment": "2016-06-27 17:52:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/85cf9c48-3f92-11e6-8a84-bae500000096",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"id": "85cf9c48-3f92-11e6-8a84-bae500000096",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 16:50:51",
"name": "333444",
"description": "Не совсем Новый Входящий платёж",
"code": "101010001",
"externalCode": "2213sfkksbajf214812slkanf",
"moment": "2012-06-27 16:52:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 40020,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"incomingNumber": "3",
"incomingDate": "2016-03-17 10:52:24"
}
]
Удалить Входящий платеж
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Входящего платежа. |
Запрос на удаление Входящего платежа с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Входящего платежа.
Метаданные Входящих платежей
Метаданные Входящих платежей
Запрос на получение метаданных Входящих платежей. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Входящих платежей + attributes - Массив объектов доп. полей Входящих платежей в формате Метаданных + states - Массив статусов Входящих платежей + createShared - создавать новые Входящие платежи с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Входящих платежей
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Входящих платежей.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/attributes/fd6114e2-3f91-11e6-8a84-bae500000107",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "fd6114e2-3f91-11e6-8a84-bae500000107",
"name": "Доля",
"type": "long",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/attributes/fd611bc1-3f91-11e6-8a84-bae500000108",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "fd611bc1-3f91-11e6-8a84-bae500000108",
"name": "Попытки",
"type": "long",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/attributes/fd612138-3f91-11e6-8a84-bae500000109",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "fd612138-3f91-11e6-8a84-bae500000109",
"name": "Поступил",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/states/ab8f5213-3f8e-11e6-8a84-bae5000000f5",
"type": "state",
"mediaType": "application/json"
},
"id": "ab8f5213-3f8e-11e6-8a84-bae5000000f5",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Оформлен",
"color": 10066329,
"stateType": "Regular",
"entityType": "paymentin"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/states/ab8f5a56-3f8e-11e6-8a84-bae5000000f6",
"type": "state",
"mediaType": "application/json"
},
"id": "ab8f5a56-3f8e-11e6-8a84-bae5000000f6",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Переведён",
"color": 10066329,
"stateType": "Regular",
"entityType": "paymentin"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/states/ab8f612b-3f8e-11e6-8a84-bae5000000f7",
"type": "state",
"mediaType": "application/json"
},
"id": "ab8f612b-3f8e-11e6-8a84-bae5000000f7",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Получен",
"color": 10066329,
"stateType": "Regular",
"entityType": "paymentin"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/attributes/04d7d27c-558b-11e6-8a84-bae500000075",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "04d7d27c-558b-11e6-8a84-bae500000075",
"name": "Импорировано из банка",
"type": "boolean",
"required": false
}
Шаблон входящего платежа
Шаблон входящего платежа
Запрос на получение предзаполненого стандартными значениями шаблона входящего платежа без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного входящего платежа.
{
"applicable": true,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}
Шаблон входящего платежа на основе
Запрос на получение предзаполненного входящего платежа на основе другого документа. В результате запроса, будет создан предзаполненный шаблон входящего платёжа на основе переданного документа.
Запрос на получение шаблона входящего платежа на основе заказа покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного входящего платежа.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по заказу № 0302201 от 2016-10-13 12:38:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Запрос на получение шаблона входящего платежа на основе возврата поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/4f5e259b-961a-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного входящего платежа.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по возврату поставщику № 00001 от 2016-10-19 19:37:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/4f5e259b-961a-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Запрос на получение шаблона входящего платежа на основе отгрузки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/06406b97-9138-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного входящего платежа.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по отгрузке № 000201 от 2016-10-13 12:38:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/06406b97-9138-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Запрос на получение шаблона входящего платежа на основе счета покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного входящего платежа.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/2b0f10e4-9169-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по счету № 53252 от 2016-10-19 15:06:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Запрос на получение шаблона входящего платежа на основе полученного отчёта комиссионера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/fe44fe4f-b320-11e6-8a84-bae500000092",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного входящего платежа.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 18:13:31",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 10350000,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/c3057574-ab01-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по полученному отчету комиссионера № 0000000000000001 от 2016-11-25 18:07:00. Сумма: 103 500,00 без НДС",
"vatSum": 0,
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/fe44fe4f-b320-11e6-8a84-bae500000092",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"linkedSum": 10350000
}
]
}
Входящий платеж
Получить Входящий платеж
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Входящего платежа. |
Запрос на получение отдельного Входящего платежа с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Входящего платежа.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/ad1ffc02-3f8e-11e6-8a84-bae5000000fa",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"id": "ad1ffc02-3f8e-11e6-8a84-bae5000000fa",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 16:21:10",
"name": "00001",
"description": "Платёж за красивые глаза",
"externalCode": "8hBoVBUMiDeumkozzjwX83",
"moment": "2016-07-01 16:19:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 124124100,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/2b34d43f-3f52-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata/states/ab8f5213-3f8e-11e6-8a84-bae5000000f5",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d/accounts/1489ad8d-32ca-11e6-8a84-bae50000000e",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "За красивые глаза",
"incomingNumber": "12412569",
"incomingDate": "2016-07-22 00:00:00"
}
Изменить Входящий платеж
Запрос на обновление Входящего платежа с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Входящего платежа, кроме тех, что
помечены Только для чтения в описании атрибутов Входящего платежа.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Для привязки входящего платежа к другим документам
нужно положить в поле под именем operations все meta тех документов, к которым вы хотите привязать финансовую операцию.
Также для каждого документа можно указать cумму, оплаченную по данному документу из этого платежа linkedSum.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Входящего платежа. |
Пример запроса на обновление отдельного Входящего платежа.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "333444",
"description": "Не совсем Новый Входящий платёж",
"code": "101010001",
"externalCode": "2213sfkksbajf214812slkanf",
"moment": "2012-06-27 17:52:24",
"applicable": true,
"sum": 40020,
"incomingNumber": "3",
"incomingDate": "2016-03-17 10:52:24"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Входящего платежа.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/85cf9c48-3f92-11e6-8a84-bae500000096",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"id": "85cf9c48-3f92-11e6-8a84-bae500000096",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 16:50:51",
"name": "333444",
"description": "Не совсем Новый Входящий платёж",
"code": "101010001",
"externalCode": "2213sfkksbajf214812slkanf",
"moment": "2012-06-27 16:52:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 40020,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"incomingNumber": "3",
"incomingDate": "2016-03-17 10:52:24"
}
Документ Исходящий платеж
Исходящие платежи
Средствами JSON API можно создавать и обновлять сведения о Исходящем платеже, запрашивать списки Исходящих платежей и сведения по отдельным Исходящим платежам. Кодом сущности для Исходящего платежа в составе JSON API является ключевое слово paymentout. Больше о платежа х и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Атрибуты сущности
- meta - Метаданные о Исходящем платеже
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Исходящего платежа
- description - Комментарий Исходящего платежа
- externalCode - Внешний код Исходящего платежа
- moment - Дата Исходящего платежа
- applicable - Отметка о проведении
- sum - Сумма Исходящего платежа в установленной валюте
- project - Ссылка на проект в формате Метаданных
- rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента или юрлицо в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- state - Статус Исходящего платежа в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - paymentPurpose - Назначение платежа
- vatSum - Сумма включая НДС
- expenseItem - Статья расходов в формате Метаданных
Необходимое
Связи с другими документами
- factureIn - Ссылка на Счет-фактура полученный, с которым связан этот платеж, в формате Метаданных
- operations - Массив ссылок на связанные операции
- meta - Ссылка на операцию, к которой привязан этот платёж в формате метаданных
- linkedSum - Сумма, оплаченная по данному документу из этого платежа
Разрешенные типы связанных операций: + Возврат покупателя (salesreturn) + Приёмка (supply) + Счёт поставщика (invoicein) + Заказ поставщику (purchaseorder) + Выданный отчёт комиссионера (commissionreportout)
О работе с доп. полями Исходящих платежей можно прочитать здесь
Получить Исходящие платежи
Запрос всех Исходящих платежей на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Исходящие платежи .
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить Исходящие платежи
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Исходящих платежей .
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/64aa2e8c-3f95-11e6-8a84-bae50000010f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json"
},
"id": "64aa2e8c-3f95-11e6-8a84-bae50000010f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 17:09:15",
"name": "00001",
"description": "Платим контрагенту",
"externalCode": "1PPP5fDei13CwEHXYUpV62",
"moment": "2016-07-01 17:07:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 12525000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/4680d884-3f95-11e6-8a84-bae50000010c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1496c09e-32ca-11e6-8a84-bae50000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata/attributes/ebc69be9-3f91-11e6-8a84-bae500000104",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ebc69be9-3f91-11e6-8a84-bae500000104",
"name": "Поступил",
"type": "boolean",
"value": false
}
],
"paymentPurpose": "Оплата по счету за приёмку",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/6c527858-3f95-11e6-8a84-bae500000113",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json"
},
"id": "6c527858-3f95-11e6-8a84-bae500000113",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 17:09:28",
"name": "00002",
"externalCode": "ixPEZ2RyieYILZJ73FkAT1",
"moment": "2016-07-01 17:09:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d/accounts/1489ad8d-32ca-11e6-8a84-bae50000000e",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata/attributes/ebc69be9-3f91-11e6-8a84-bae500000104",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ebc69be9-3f91-11e6-8a84-bae500000104",
"name": "Поступил",
"type": "boolean",
"value": false
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/90ba347d-6b8b-11e6-8a84-bae5000000bd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"linkedSum": 80000
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/d557dabe-3d3e-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json"
},
"id": "d557dabe-3d3e-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-28 17:44:35",
"name": "408",
"externalCode": "Q7wBn7oYh-B70arUTG08u3",
"moment": "2015-06-19 00:00:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 7283600,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/c466c1a8-3d2d-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/c466c1a8-3d2d-11e6-8a84-bae500000000/accounts/c4673735-3d2d-11e6-8a84-bae500000001",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата за ноутбук по счету № 340 от 19 июня 2015 Без НДС",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
]
}
Создать Исходящий платеж
Запрос на создание нового Исходящего платежа . Обязательные для создания поля: + name - номер Исходящего платежа + organization - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на контрагента в формате Метаданных + expenseItem - Статья расходов в формате Метаданных
Пример создания нового Исходящего платежа с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout
"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "333222",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Исходящего платежа .
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/99434e4c-3fa0-11e6-8a84-bae50000009c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json"
},
"id": "99434e4c-3fa0-11e6-8a84-bae50000009c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "333222",
"moment": "2016-06-27 17:52:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Массовое создание и обновление Исходящих платежей
Массовое создание и обновление Исходящих платежей. В теле запроса нужно передать массив, содержащий JSON представления Исходящих платежей, которые вы хотите создать или обновить. Обновляемые Исходящие платежи должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Исходящих платежей
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "333222",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/99434e4c-3fa0-11e6-8a84-bae50000009c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json"
},
"name": "888",
"description": "НИП",
"sum": 999,
"code": "39393",
"externalCode": "o34bajf214812slkanf",
"moment": "2012-10-31 15:52:24",
"applicable": true
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Исходящих платежей.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/99434e4c-3fa0-11e6-8a84-bae50000009c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json"
},
"id": "99434e4c-3fa0-11e6-8a84-bae50000009c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "333222",
"moment": "2016-06-27 17:52:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/99434e4c-3fa0-11e6-8a84-bae50000009c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json"
},
"id": "99434e4c-3fa0-11e6-8a84-bae50000009c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 18:32:14",
"name": "888",
"description": "НИП",
"code": "39393",
"externalCode": "o34bajf214812slkanf",
"moment": "2012-10-31 14:52:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 999,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
]
Удалить Исходящий платеж
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Исходящего платежа. |
Запрос на удаление Исходящего платежа с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Исходящего платежа .
Метаданные Исходящих платежей
Метаданные Исходящих платежей
Запрос на получение метаданных Исходящих платежей . Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Исходящих платежей + attributes - Массив объектов доп. полей Исходящих платежей в формате Метаданных + states - Массив статусов Исходящих платежей + createShared - создавать новые Исходящие платежи с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Исходящих платежей
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Исходящих платежей .
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata/attributes/ebc68f7a-3f91-11e6-8a84-bae500000102",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ebc68f7a-3f91-11e6-8a84-bae500000102",
"name": "Доля",
"type": "double",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata/attributes/ebc69606-3f91-11e6-8a84-bae500000103",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ebc69606-3f91-11e6-8a84-bae500000103",
"name": "Попытки",
"type": "long",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata/attributes/ebc69be9-3f91-11e6-8a84-bae500000104",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ebc69be9-3f91-11e6-8a84-bae500000104",
"name": "Поступил",
"type": "boolean",
"required": false
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata/attributes/ed00a639-558a-11e6-8a84-bae500000072",
"type": "attributemetadata",
"mediaType": "application/json"
},
"customEntityMeta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/metadata/customEntities/a27aa372-5311-11e6-8a84-bae500000001",
"type": "customentitymetadata",
"mediaType": "application/json"
},
"id": "ed00a639-558a-11e6-8a84-bae500000072",
"name": "Сущности",
"type": "customentity",
"required": false
}
Шаблон исходящего платежа
Шаблон исходящего платежа
Запрос на получение предзаполненого стандартными значениями шаблона исходящего платежа без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного исходящего платежа.
{
"applicable": true,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Шаблон исходящего платежа на основе
Запрос на создание получение прелзаполненного исходящего платежа на основе другого документа. В результате запроса, будет создан предзаполненный шаблон исходящего платёж на основе переданного документа.
Запрос на получение шаблона исходящего платежа на основе заказа поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/17a06771-961b-11e6-8a84-bae500000080",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного исходящего платежа.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942953e-9128-11e6-8a84-bae500000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по заказу № 00001 от 2016-10-19 19:42:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/17a06771-961b-11e6-8a84-bae500000080",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"linkedSum": 0
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Запрос на получение шаблона исходящего платежа на основе возврата покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/3b0f51a4-961b-11e6-8a84-bae500000086",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного исходящего платежа.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/2b0f10e4-9169-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Возврат по накладной № 00001 от 2016-10-19 19:43:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/3b0f51a4-961b-11e6-8a84-bae500000086",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"linkedSum": 0
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2395a-0479-11e5-baee-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Запрос на получение шаблона исходящего платежа на основе приёмки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/0f57efd5-91f3-11e6-8a84-bae500000086",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного исходящего платежа.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по накладной № 123 от 2016-10-14 12:46:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/0f57efd5-91f3-11e6-8a84-bae500000086",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"linkedSum": 0
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Запрос на получение шаблона исходящего платежа на основе счёта поставщика.
shell curl -X PUT "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/new" -H "Authorization: Basic <Access-Token>" -H "Content-Type: application/json" -d '{ "operations": [ { "meta": { "href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/e43b34bc-961a-11e6-8a84-bae50000006f", "metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata", "type": "invoicein", "mediaType": "application/json" } } ] }'Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного исходящего платежа.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по счету № 00001 от 2016-10-19 19:41:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/e43b34bc-961a-11e6-8a84-bae50000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"linkedSum": 0
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Запрос на получение шаблона исходящего платежа на основе выданного отчёта комиссионера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/394e3f39-b322-11e6-8a84-bae50000009e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного исходящего платежа.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 18:19:15",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 10200850,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/c3057574-ab01-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по выданному отчету комиссионера № 0000000000000000002 от 2016-11-25 18:16:00. Сумма: 102 008,50 без НДС",
"vatSum": 0,
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/394e3f39-b322-11e6-8a84-bae50000009e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"linkedSum": 10200850
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Исходящий платеж
Получить Исходящий платеж
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Исходящего платежа. |
Запрос на получение отдельного Исходящего платежа с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Исходящего платежа.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/64aa2e8c-3f95-11e6-8a84-bae50000010f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json"
},
"id": "64aa2e8c-3f95-11e6-8a84-bae50000010f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 17:09:15",
"name": "00001",
"description": "Платим контрагенту",
"externalCode": "1PPP5fDei13CwEHXYUpV62",
"moment": "2016-07-01 17:07:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 12525000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/4680d884-3f95-11e6-8a84-bae50000010c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1496c09e-32ca-11e6-8a84-bae50000001b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata/attributes/ebc69be9-3f91-11e6-8a84-bae500000104",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "ebc69be9-3f91-11e6-8a84-bae500000104",
"name": "Поступил",
"type": "boolean",
"value": false
}
],
"paymentPurpose": "Оплата по счету за приёмку",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/90ba347d-6b8b-11e6-8a84-bae5000000bd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"linkedSum": 80000
}
]
}
Изменить Исходящий платеж
Запрос на обновление Исходящего платежа с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Исходящего платежа , кроме тех, что
помечены Только для чтения в описании атрибутов Исходящего платежа .
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Для привязки исходящего платежа к другим документам нужно положить в поле под именем operations все meta тех документов, к которым вы хотите привязать финансовую операцию. Также для каждого документа можно указать cумму, оплаченную по данному документу из этого платежа linkedSum.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Исходящего платежа. |
Пример запроса на обновление отдельного Исходящего платежа .
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/paymentout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "888",
"description": "НИП",
"sum": 999,
"code": "39393",
"externalCode": "o34bajf214812slkanf",
"moment": "2012-10-31 15:52:24",
"applicable": true
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Исходящего платежа .
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/99434e4c-3fa0-11e6-8a84-bae50000009c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json"
},
"id": "99434e4c-3fa0-11e6-8a84-bae50000009c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 18:32:14",
"name": "888",
"description": "НИП",
"code": "39393",
"externalCode": "o34bajf214812slkanf",
"moment": "2012-10-31 14:52:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 999,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Документ Приходный ордер
Приходные ордера
Средствами JSON API можно создавать и обновлять сведения о Приходном ордере, запрашивать списки Приходных ордеров и сведения по отдельным Приходным ордерам.Кодом сущности для Приходного ордера в составе JSON API является ключевое слово cashin.
Атрибуты сущности
- meta - Метаданные о Приходном ордере
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Приходного ордера
- description - Комментарий Приходного ордера
- externalCode - Внешний код Приходного ордера
- moment - Дата Приходного ордера
- applicable - Отметка о проведении
- sum - Сумма Приходного ордера в установленной валюте
- project - Ссылка на проект в формате Метаданных
- rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента, юрлицо или сотрудника в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- state - Статус Приходного ордера в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - paymentPurpose - Основание
- vatSum - Сумма включая НДС #### Связи с другими документами
- factureOut - Ссылка на Счет-фактура выданный, с которым связан этот Приходный ордер, в формате Метаданных
- operations - Массив ссылок на связанные операции в формате Метаданных
- meta - Ссылка на операцию, к которой привязан этот платёж в формате метаданных
- linkedSum - Сумма, оплаченная по данному документу из этого платежа
Разрешенные типы связанных операций: + Заказ покупателя (customerorder) + Возврат поставщику (purchasereturn) + Отгрузка (demand) + Счёт покупателю (invoiceout) + Полученный отчёт комиссионера (commissionreportin) + Смена (retailShift)
О работе с доп. полями Приходных ордеров можно прочитать здесь
Получить Приходные ордера
Запрос всех Приходных ордеров на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Приходные ордера.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить Приходные ордера
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/cashin"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Приходных ордеров.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/07ea2c6f-3fad-11e6-8a84-bae50000013f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "07ea2c6f-3fad-11e6-8a84-bae50000013f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 08:58:24",
"name": "00003",
"description": "И ещё один приходный ордер",
"externalCode": "0fI6AjAHh-x1oYYNwBYeN1",
"moment": "2016-07-04 08:57:00",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 132000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/0028cec8-3fad-11e6-8a84-bae50000013c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/15121cef-32ca-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/states/aaa6d501-3fac-11e6-8a84-bae50000012e",
"type": "state",
"mediaType": "application/json"
}
},
"paymentPurpose": "И ещё одна оплата заказа.",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/90ba347d-6b8b-11e6-8a84-bae5000000bd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
},
"linkedSum": 80000
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/b0ec3c98-3fac-11e6-8a84-bae500000131",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "b0ec3c98-3fac-11e6-8a84-bae500000131",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 08:55:58",
"name": "00001",
"description": "Приходный Ордер.",
"externalCode": "E7vH1TaKii9bkuw2pekD22",
"moment": "2016-07-04 08:54:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 3189,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/2b34d43f-3f52-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/states/aaa6c45a-3fac-11e6-8a84-bae50000012b",
"type": "state",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата заказа",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/90ba347d-6b8b-11e6-8a84-bae5000000bd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
},
"linkedSum": 80000
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/df861103-3fac-11e6-8a84-bae500000137",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "df861103-3fac-11e6-8a84-bae500000137",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 08:57:19",
"name": "00002",
"description": "Еще приходный ордер.",
"externalCode": "FEYR3meShqh5ICWNygGeq0",
"moment": "2016-07-04 08:56:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1700000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/c556343a-3fac-11e6-8a84-bae500000134",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/14c505eb-32ca-11e6-8a84-bae500000045",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/states/aaa6cfcf-3fac-11e6-8a84-bae50000012d",
"type": "state",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата второго заказа"
}
]
}
Создать Приходный ордер
Запрос на создание нового Приходного ордера. Обязательные для создания поля: + name - номер Приходного ордера + organization - Ссылка на ваше орлицо в формате Метаданных + agent - Ссылка на контрагента в формате Метаданных
Пример создания нового Приходного ордера с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/cashin"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "000712",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Приходного ордера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/3fd08b2d-41b0-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "3fd08b2d-41b0-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "000712",
"moment": "2012-06-10 09:52:24",
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}
Массовое создание и обновление Приходных ордеров
Массовое создание и обновление Приходных ордеров. В теле запроса нужно передать массив, содержащий JSON представления Приходных ордеров, которые вы хотите создать или обновить. Обновляемые Приходные ордера должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Приходных ордеров
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/cashin"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "000712",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/3fd08b2d-41b0-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f3c5d206-dafc-4eb3-8678-f97e76964e1d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"name": "000722",
"description": "Приходный ордер созданный и изменённый через API",
"code": "333712366",
"externalCode": "103kek312",
"moment": "2016-06-10 09:52:24",
"applicable": false,
"sum": 555000,
"paymentPurpose": "Оплата заказа №0046",
"attributes": [
{
"id": "c57c1f22-3fae-11e6-8a84-bae500000142",
"value": 12
},
{
"id": "c57c2526-3fae-11e6-8a84-bae500000143",
"value": true
},
{
"id": "c57c2a5c-3fae-11e6-8a84-bae500000144",
"value": 3.13
}
]
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Приходных ордеров.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/3fd08b2d-41b0-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "3fd08b2d-41b0-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "000712",
"moment": "2012-06-10 09:52:24",
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/3fd08b2d-41b0-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "3fd08b2d-41b0-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f3c5d206-dafc-4eb3-8678-f97e76964e1d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 09:54:38",
"name": "000722",
"description": "Приходный ордер созданный и изменённый через API",
"code": "333712366",
"externalCode": "103kek312",
"moment": "2016-06-10 09:52:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 3700,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c57c1f22-3fae-11e6-8a84-bae500000142",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c57c1f22-3fae-11e6-8a84-bae500000142",
"name": "Карма",
"type": "long",
"value": 12
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c57c2526-3fae-11e6-8a84-bae500000143",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c57c2526-3fae-11e6-8a84-bae500000143",
"name": "С основанием",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c57c2a5c-3fae-11e6-8a84-bae500000144",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c57c2a5c-3fae-11e6-8a84-bae500000144",
"name": "Коэффициент",
"type": "double",
"value": 3.13
}
],
"paymentPurpose": "Оплата заказа №0046"
}
]
Удалить Приходный ордер
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приходного ордера. |
Запрос на удаление Приходного ордера с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Приходного ордера.
Метаданные Приходных ордеров
Метаданные Приходных ордеров
Запрос на получение метаданных Приходных ордеров. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Приходных ордеров + attributes - Массив объектов доп. полей Приходных ордеров в формате Метаданных + states - Массив статусов Приходных ордеров + createShared - создавать новые Приходные ордера с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Приходных ордеров
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Приходных ордеров.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c57c1f22-3fae-11e6-8a84-bae500000142",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c57c1f22-3fae-11e6-8a84-bae500000142",
"name": "Карма",
"type": "long",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c57c2526-3fae-11e6-8a84-bae500000143",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c57c2526-3fae-11e6-8a84-bae500000143",
"name": "С основанием",
"type": "boolean",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c57c2a5c-3fae-11e6-8a84-bae500000144",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c57c2a5c-3fae-11e6-8a84-bae500000144",
"name": "Коэффициент",
"type": "double",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/states/aaa6c45a-3fac-11e6-8a84-bae50000012b",
"type": "state",
"mediaType": "application/json"
},
"id": "aaa6c45a-3fac-11e6-8a84-bae50000012b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Выслан",
"color": 15280409,
"stateType": "Regular",
"entityType": "cashin"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/states/aaa6ca7a-3fac-11e6-8a84-bae50000012c",
"type": "state",
"mediaType": "application/json"
},
"id": "aaa6ca7a-3fac-11e6-8a84-bae50000012c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Принят",
"color": 34617,
"stateType": "Regular",
"entityType": "cashin"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/states/aaa6cfcf-3fac-11e6-8a84-bae50000012d",
"type": "state",
"mediaType": "application/json"
},
"id": "aaa6cfcf-3fac-11e6-8a84-bae50000012d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Ожидается",
"color": 15106326,
"stateType": "Regular",
"entityType": "cashin"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/states/aaa6d501-3fac-11e6-8a84-bae50000012e",
"type": "state",
"mediaType": "application/json"
},
"id": "aaa6d501-3fac-11e6-8a84-bae50000012e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Оформлен",
"color": 10774205,
"stateType": "Regular",
"entityType": "cashin"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c7f589f9-558a-11e6-8a84-bae50000006f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c7f589f9-558a-11e6-8a84-bae50000006f",
"name": "Карма",
"type": "long",
"required": false
}
Шаблон приходного ордера
Шаблон приходного ордера
Запрос на получение предзаполненного приходного ордера со стандартными полями без связи с какими-либо другими документами.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного приходного ордера.
{
"applicable": true,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}
Шаблон приходного ордера на основе
Запрос на получение шаблона приходного ордера на основе другого документа. В результате запроса, будет предзаполненный приходный ордер на основе переданного документа.
Запрос на получение шаблона приходного ордера на основе заказа покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного приходного ордера.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по заказу № 0302201 от 2016-10-13 12:38:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Запрос на получение шаблона приходного ордера на основе возврата поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/4f5e259b-961a-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного приходного ордера.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по возврату поставщику № 00001 от 2016-10-19 19:37:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/4f5e259b-961a-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Запрос на получение шаблона приходного ордера на основе отгрузки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/06406b97-9138-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного приходного ордера.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по отгрузке № 000201 от 2016-10-13 12:38:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/06406b97-9138-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Запрос на получение шаблона приходного ордера на основе счёта покупателю.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного приходного ордера.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/2b0f10e4-9169-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по счету № 53252 от 2016-10-19 15:06:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/6cb87758-95f4-11e6-8a84-bae500000067",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
Запрос на получение шаблона приходного ордера на основе полученного отчёта комиссионера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/fe44fe4f-b320-11e6-8a84-bae500000092",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного приходного ордера.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 18:09:50",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 10350000,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/c3057574-ab01-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"vatSum": 0,
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/fe44fe4f-b320-11e6-8a84-bae500000092",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"linkedSum": 10350000
}
]
}
Приходный ордер
Получить Приходный ордер
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приходного ордера. |
Запрос на получение отдельного Приходного ордера с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Приходного ордера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/b0ec3c98-3fac-11e6-8a84-bae500000131",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "b0ec3c98-3fac-11e6-8a84-bae500000131",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 08:55:58",
"name": "00001",
"description": "Приходный Ордер.",
"externalCode": "E7vH1TaKii9bkuw2pekD22",
"moment": "2016-07-04 08:54:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 3189,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/2b34d43f-3f52-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/states/aaa6c45a-3fac-11e6-8a84-bae50000012b",
"type": "state",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата заказа",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/90ba347d-6b8b-11e6-8a84-bae5000000bd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
},
"linkedSum": 80000
}
]
}
Изменить Приходный ордер
Запрос на обновление Приходного ордера с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Приходного ордера, кроме тех, что
помечены Только для чтения в описании атрибутов Приходного ордера.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Для привязки приходного ордера к другим документам
нужно положить в поле под именем operations все meta тех документов, к которым вы хотите привязать финансовую операцию.
Также для каждого документа можно указать cумму, оплаченную по данному документу из этого платежа linkedSum.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приходного ордера. |
Пример запроса на обновление отдельного Приходного ордера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f3c5d206-dafc-4eb3-8678-f97e76964e1d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"name": "000722",
"description": "Приходный ордер созданный и изменённый через API",
"code": "333712366",
"externalCode": "103kek312",
"moment": "2016-06-10 09:52:24",
"applicable": false,
"sum": 555000,
"paymentPurpose": "Оплата заказа №0046",
"attributes": [
{
"id": "c57c1f22-3fae-11e6-8a84-bae500000142",
"value": 12
},
{
"id": "c57c2526-3fae-11e6-8a84-bae500000143",
"value": true
},
{
"id": "c57c2a5c-3fae-11e6-8a84-bae500000144",
"value": 3.13
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Приходного ордера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/3fd08b2d-41b0-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata",
"type": "cashin",
"mediaType": "application/json"
},
"id": "3fd08b2d-41b0-11e6-8a84-bae500000000",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f3c5d206-dafc-4eb3-8678-f97e76964e1d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 09:54:38",
"name": "000722",
"description": "Приходный ордер созданный и изменённый через API",
"code": "333712366",
"externalCode": "103kek312",
"moment": "2016-06-10 09:52:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 3700,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c57c1f22-3fae-11e6-8a84-bae500000142",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c57c1f22-3fae-11e6-8a84-bae500000142",
"name": "Карма",
"type": "long",
"value": 12
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c57c2526-3fae-11e6-8a84-bae500000143",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c57c2526-3fae-11e6-8a84-bae500000143",
"name": "С основанием",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashin/metadata/attributes/c57c2a5c-3fae-11e6-8a84-bae500000144",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c57c2a5c-3fae-11e6-8a84-bae500000144",
"name": "Коэффициент",
"type": "double",
"value": 3.13
}
],
"paymentPurpose": "Оплата заказа №0046"
}
Документ Расходный ордер
Расходные ордера
Средствами JSON API можно создавать и обновлять сведения о Расходном ордере, запрашивать списки Расходных ордеров и сведения по отдельным Расходных ордеров. Кодом сущности для Расходного ордера в составе JSON API является ключевое слово cashout.
Атрибуты сущности
- meta - Метаданные о Расходном ордере
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Расходного ордера
- description - Комментарий Расходного ордера
- externalCode - Внешний код Расходного ордера
- moment - Дата Расходного ордера
- applicable - Отметка о проведении
- sum - Сумма Расходного ордера в установленной валюте
- project - Ссылка на проект в формате Метаданных
- rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента, юрлицо или сотрудника в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- state - Статус Расходного ордера в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - paymentPurpose - Основание
- vatSum - Сумма включая НДС
- expenseItem - Статья расходов в формате Метаданных
Необходимое#### Связи с другими документами - factureIn - Ссылка на Счет-фактура полученный, с которым связан этот Расходный ордер в формате Метаданных
- operations - Массив ссылок на связанные операции в формате Метаданных
- meta - Ссылка на операцию, к которой привязан этот платёж в формате метаданных
- linkedSum - Сумма, оплаченная по данному документу из этого платежа
Разрешенные типы связанных операций: + Возврат покупателя (salesreturn) + Приёмка (supply) + Счёт поставщика (invoicein) + Заказ поставщику (purchaseorder) + Выданный отчёт комиссионера (commissionreportout)
О работе с доп. полями Расходных ордеров можно прочитать здесь
Получить Расходные ордера
Запрос всех Расходных ордеров на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Расходные ордера .
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить Расходные ордера
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/cashin"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Расходных ордеров.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/235c14cf-41b1-11e6-8a84-bae500000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json"
},
"id": "235c14cf-41b1-11e6-8a84-bae500000073",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 09:32:53",
"name": "00002",
"description": "Лол",
"externalCode": "wWfQT10VjQztCieUrE72r2",
"moment": "2016-07-04 09:31:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 35000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/2b34d43f-3f52-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/states/0eda7963-41b1-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c8857703-3f8e-11e6-8a84-bae5000000ff",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c8857703-3f8e-11e6-8a84-bae5000000ff",
"name": "Поступил",
"type": "boolean",
"value": false
}
],
"paymentPurpose": "Оплата ещё одной приёмки",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/489afb43-41b1-11e6-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json"
},
"id": "489afb43-41b1-11e6-8a84-bae50000007a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 09:33:56",
"name": "00003",
"description": "Лмао",
"externalCode": "Q9wiyzIQiOhYhqpVkq6IE2",
"moment": "2016-07-04 09:32:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 3535000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/37def9c0-41b1-11e6-8a84-bae500000077",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1509a2f7-32ca-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/states/0eda7963-41b1-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c8857703-3f8e-11e6-8a84-bae5000000ff",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c8857703-3f8e-11e6-8a84-bae5000000ff",
"name": "Поступил",
"type": "boolean",
"value": false
}
],
"paymentPurpose": "Оплата ещё одной приёмки",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/90ba347d-6b8b-11e6-8a84-bae5000000bd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"linkedSum": 80000
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/fd9b07ea-41b0-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json"
},
"id": "fd9b07ea-41b0-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 09:34:14",
"name": "00001",
"description": "Ордер созданный через UI.",
"externalCode": "Biim5OxdjUnFcC2saaU551",
"moment": "2016-07-04 09:30:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 3174603,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e16fc992-41b0-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/states/0eda8542-41b1-11e6-8a84-bae500000070",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c8857703-3f8e-11e6-8a84-bae5000000ff",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c8857703-3f8e-11e6-8a84-bae5000000ff",
"name": "Поступил",
"type": "boolean",
"value": false
}
],
"paymentPurpose": "Оплата приёмки",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/82031d62-2e58-11e6-ab5c-d8cb8a84bae5",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
]
}
Создать Расходный ордер
Запрос на создание нового Расходного ордера. Обязательные для создания поля: + name - номер Расходного ордера + organization - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на контрагента в формате Метаданных + expenseItem - Статья расходов в формате Метаданных
Пример создания нового Расходного ордера с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/cashout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "0721",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Расходного ордера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/e446a227-41b1-11e6-8a84-bae500000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json"
},
"id": "e446a227-41b1-11e6-8a84-bae500000005",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "0721",
"moment": "2012-06-27 16:52:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Массовое создание и обновление Расходных ордеров
Массовое создание и обновление Расходных ордеров. В теле запроса нужно передать массив, содержащий JSON представления Расходных ордеров, которые вы хотите создать или обновить. Обновляемые Расходные ордера должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Расходных ордеров
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/cashout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "0721",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/e446a227-41b1-11e6-8a84-bae500000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json"
},
"shared": true,
"name": "0722",
"description": "Расходный ордер созданный и обновлённый через API",
"code": "12412470912",
"externalCode": "unreal777slknf",
"moment": "2016-06-27 16:52:24",
"applicable": true,
"sum": 25190,
"paymentPurpose": "Оплата нового заказа поставщику",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be23a18-0479-11e5-a260-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "c88569fc-3f8e-11e6-8a84-bae5000000fd",
"value": 0.49
},
{
"id": "c88570d2-3f8e-11e6-8a84-bae5000000fe",
"value": 7501
},
{
"id": "c8857703-3f8e-11e6-8a84-bae5000000ff",
"value": true
}
]
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Расходных ордеров.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/e446a227-41b1-11e6-8a84-bae500000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json"
},
"id": "e446a227-41b1-11e6-8a84-bae500000005",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "0721",
"moment": "2012-06-27 16:52:24",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/e446a227-41b1-11e6-8a84-bae500000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json"
},
"id": "e446a227-41b1-11e6-8a84-bae500000005",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 09:41:17",
"name": "0722",
"description": "Расходный ордер созданный и обновлённый через API",
"code": "12412470912",
"externalCode": "unreal777slknf",
"moment": "2016-06-27 16:52:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 900,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c88569fc-3f8e-11e6-8a84-bae5000000fd",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c88569fc-3f8e-11e6-8a84-bae5000000fd",
"name": "Доля",
"type": "double",
"value": 0.49
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c88570d2-3f8e-11e6-8a84-bae5000000fe",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c88570d2-3f8e-11e6-8a84-bae5000000fe",
"name": "Попытки",
"type": "long",
"value": 7501
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c8857703-3f8e-11e6-8a84-bae5000000ff",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c8857703-3f8e-11e6-8a84-bae5000000ff",
"name": "Поступил",
"type": "boolean",
"value": true
}
],
"paymentPurpose": "Оплата нового заказа поставщику",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be23a18-0479-11e5-a260-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
]
Удалить Расходный ордер
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Расходного ордера. |
Запрос на удаление Расходного ордера с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Расходного ордера.
Метаданные Расходных ордеров
Метаданные Расходных ордеров
Запрос на получение метаданных Расходных ордеров. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Расходных ордеров + attributes - Массив объектов доп. полей Расходных ордеров в формате Метаданных + states - Массив статусов Расходных ордеров + createShared - создавать новые Расходные ордера с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Расходных ордеров
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Расходных ордеров.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c88569fc-3f8e-11e6-8a84-bae5000000fd",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c88569fc-3f8e-11e6-8a84-bae5000000fd",
"name": "Доля",
"type": "double",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c88570d2-3f8e-11e6-8a84-bae5000000fe",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c88570d2-3f8e-11e6-8a84-bae5000000fe",
"name": "Попытки",
"type": "long",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c8857703-3f8e-11e6-8a84-bae5000000ff",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c8857703-3f8e-11e6-8a84-bae5000000ff",
"name": "Поступил",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/states/0eda7963-41b1-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
},
"id": "0eda7963-41b1-11e6-8a84-bae50000006e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Kek",
"color": 10667543,
"stateType": "Regular",
"entityType": "cashout"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/states/0eda80ad-41b1-11e6-8a84-bae50000006f",
"type": "state",
"mediaType": "application/json"
},
"id": "0eda80ad-41b1-11e6-8a84-bae50000006f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Lol",
"color": 4354177,
"stateType": "Regular",
"entityType": "cashout"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/states/0eda8542-41b1-11e6-8a84-bae500000070",
"type": "state",
"mediaType": "application/json"
},
"id": "0eda8542-41b1-11e6-8a84-bae500000070",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "LMAO",
"color": 15491487,
"stateType": "Regular",
"entityType": "cashout"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/b54f1d9c-558a-11e6-8a84-bae50000006c",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "b54f1d9c-558a-11e6-8a84-bae50000006c",
"name": "Строка",
"type": "string",
"required": false
}
Шаблон расходного ордера
Шаблон расходного ордера
Запрос на получение предзаполненого стандартными значениями шаблона расходного ордера без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного расходного ордера.
{
"applicable": true,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Шаблон расходного ордера на основе
Запрос на получение предзаполненного представления расходного ордера на основе другого документа.
Запрос на получение шаблона расходного ордера на основе заказа поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/17a06771-961b-11e6-8a84-bae500000080",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного расходного ордера.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942953e-9128-11e6-8a84-bae500000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по заказу № 00001 от 2016-10-19 19:42:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/17a06771-961b-11e6-8a84-bae500000080",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
},
"linkedSum": 0
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Запрос на получение шаблона расходного ордера на основе возврата покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/3b0f51a4-961b-11e6-8a84-bae500000086",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного расходного ордера.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/2b0f10e4-9169-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"paymentPurpose": "Возврат по накладной № 00001 от 2016-10-19 19:43:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/3b0f51a4-961b-11e6-8a84-bae500000086",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"linkedSum": 0
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2395a-0479-11e5-baee-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Запрос на получение шаблона расходного ордера на основе приёмки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/0f57efd5-91f3-11e6-8a84-bae500000086",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного расходного ордера.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по накладной № 123 от 2016-10-14 12:46:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/0f57efd5-91f3-11e6-8a84-bae500000086",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"linkedSum": 0
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Запрос на получение шаблона расходного ордера на основе счёта поставщика.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/e43b34bc-961a-11e6-8a84-bae50000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного расходного ордера.
{
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"paymentPurpose": "Оплата по счету № 00001 от 2016-10-19 19:41:00. Сумма: 0,00 без НДС",
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/e43b34bc-961a-11e6-8a84-bae50000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json"
},
"linkedSum": 0
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Запрос на получение шаблона расходного ордера на основе выданного отчёта комиссионера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/394e3f39-b322-11e6-8a84-bae50000009e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного расходного ордера.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 18:17:38",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 10200850,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/c3057574-ab01-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"vatSum": 0,
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/394e3f39-b322-11e6-8a84-bae50000009e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"linkedSum": 10200850
}
],
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be2350e-0479-11e5-b03a-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Расходный ордер
Получить Расходный ордер
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Расходного ордера. |
Запрос на получение отдельного Расходного ордера с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Расходного ордера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/fd9b07ea-41b0-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json"
},
"id": "fd9b07ea-41b0-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 09:34:14",
"name": "00001",
"description": "Ордер созданный через UI.",
"externalCode": "Biim5OxdjUnFcC2saaU551",
"moment": "2016-07-04 09:30:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 3174603,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/e16fc992-41b0-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/states/0eda8542-41b1-11e6-8a84-bae500000070",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c8857703-3f8e-11e6-8a84-bae5000000ff",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c8857703-3f8e-11e6-8a84-bae5000000ff",
"name": "Поступил",
"type": "boolean",
"value": false
}
],
"paymentPurpose": "Оплата приёмки",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/82031d62-2e58-11e6-ab5c-d8cb8a84bae5",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
},
"operations": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/90ba347d-6b8b-11e6-8a84-bae5000000bd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"linkedSum": 80000
}
]
}
Изменить Расходный ордер
Запрос на обновление Расходного ордера с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Расходного ордера , кроме тех, что
помечены Только для чтения в описании атрибутов Расходного ордера .
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Для привязки расходного ордера к другим документам
нужно положить в поле под именем operations все meta тех документов, к которым вы хотите привязать финансовую операцию.
Также для каждого документа можно указать cумму, оплаченную по данному документу из этого платежа linkedSum.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Расходного ордера. |
Пример запроса на обновление отдельного Расходного ордера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/cashout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"shared": true,
"name": "0722",
"description": "Расходный ордер созданный и обновлённый через API",
"code": "12412470912",
"externalCode": "unreal777slknf",
"moment": "2016-06-27 16:52:24",
"applicable": true,
"sum": 25190,
"paymentPurpose": "Оплата нового заказа поставщику",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be23a18-0479-11e5-a260-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "c88569fc-3f8e-11e6-8a84-bae5000000fd",
"value": 0.49
},
{
"id": "c88570d2-3f8e-11e6-8a84-bae5000000fe",
"value": 7501
},
{
"id": "c8857703-3f8e-11e6-8a84-bae5000000ff",
"value": true
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Расходного ордера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/e446a227-41b1-11e6-8a84-bae500000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata",
"type": "cashout",
"mediaType": "application/json"
},
"id": "e446a227-41b1-11e6-8a84-bae500000005",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 09:41:17",
"name": "0722",
"description": "Расходный ордер созданный и обновлённый через API",
"code": "12412470912",
"externalCode": "unreal777slknf",
"moment": "2016-06-27 16:52:24",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 900,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c88569fc-3f8e-11e6-8a84-bae5000000fd",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c88569fc-3f8e-11e6-8a84-bae5000000fd",
"name": "Доля",
"type": "double",
"value": 0.49
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c88570d2-3f8e-11e6-8a84-bae5000000fe",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c88570d2-3f8e-11e6-8a84-bae5000000fe",
"name": "Попытки",
"type": "long",
"value": 7501
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/cashout/metadata/attributes/c8857703-3f8e-11e6-8a84-bae5000000ff",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c8857703-3f8e-11e6-8a84-bae5000000ff",
"name": "Поступил",
"type": "boolean",
"value": true
}
],
"paymentPurpose": "Оплата нового заказа поставщику",
"expenseItem": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/1be23a18-0479-11e5-a260-448a5b426e7e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/expenseitem/metadata",
"type": "expenseitem",
"mediaType": "application/json"
}
}
}
Документ Отгрузка
Средствами JSON API можно создавать и обновлять сведения об Отгрузках, запрашивать списки Отгрузок и сведения по отдельным Отгрузкам. Позициями Отгрузок можно управлять как в составе отдельной Отгрузки, так и отдельно - с помощью специальных ресурсов для управления позициями Отгрузки. Кодом сущности для Отгрузки в составе JSON API является ключевое слово demand. Больше об Отгрузках и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Отгрузки
Атрибуты сущности
- meta - Метаданные об Отгрузке
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Отгрузки
- description - Комментарий Отгрузки
- externalCode - Внешний код Отгрузки
- moment - Дата Отгрузки
- applicable - Отметка о проведении
- vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- sum - Сумма Отгрузки в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- project - Ссылка на проект в формате Метаданных
- state - Статус Отгрузки в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:
- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
+ created - Дата создания Только для чтения
+ vatSum - Сумма НДС Только для чтения
+ positions - Ссылка на позиции в Отгрузке в формате Метаданных
+ overhead - Накладные расходы. Если Позиции Отгрузки не заданы, то накладные расходы нельзя задать
- sum - сумма накладных расходов
- distribution - Распределение накладных расходов [weight, volume, price] -> [по весу, по объёму, по цене]
+ payedSum - Сумма входящих платежей по Отгрузке
Связи с другими документами
- customerOrder - Ссылка на Заказ Покупателя, с которым связана эта Отгрузка в формате Метаданных
- factureOut - Ссылка на Счет-фактура выданный, с которым связана эта Отгрузка в формате Метаданных
- returns - Массив ссылок на связанные возвраты в формате Метаданных
- payments - Массив ссылок на связанные платежи в формате Метаданных
- invoicesOut - Массив ссылок на связанные счета покупателям в формате Метаданных
Другие поля
- consignee - Грузополучатель в формате Метаданных
- transportFacilityNumber - Номер автомобиля
- shippingInstructions - Указания грузоотправителя
- cargoName - Наименование груза
- transportFacility - Транспортное средство
- goodPackQuantity - Всего мест
- carrier - Перевозчик в формате Метаданных
- stateContractId - Идентификатор государственного контракта, договора (соглашения)
Позиции Отгрузки
Позиции Отгрузки - это список товаров/услуг/модификаций/серий.
Объект позиции Отгрузки содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ discount - Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10%
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ things - Серийные номера
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
+ cost - Себестоимость (только для услуг)
С позициями можно работать с помощью специальных ресурсов для управления позициями Отгрузки, а также в составе отдельной Отгрузки. При работе в составе отдельной Отгрузки, вы можете отправлять запросы на создание отдельной Отгрузки с включенным в тело запроса массивом позиций Отгрузки. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Отгрузки". Также, при работе в составе отдельной Отгрузки, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Отгрузки. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Отгрузки" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены. + overhead - Накладные расходы по позиции.
О работе с доп. полями Отгрузок можно прочитать здесь
Получить список Отгрузок
Запрос всех Отгрузок на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Отгрузки.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить список Отгрузок
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Отгрузок.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/?limit=2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json",
"size": 13,
"limit": 2,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/0ee24723-f640-11e5-8a84-bae500000065",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "0ee24723-f640-11e5-8a84-bae500000065",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-03-30 09:24:29",
"name": "00001",
"externalCode": "1SB6iRE9imMFJDMlab7Nk0",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-03-30 09:24:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 123000,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850efc5f-f504-11e5-8a84-bae500000161",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850efc5f-f504-11e5-8a84-bae500000161/accounts/850f0617-f504-11e5-8a84-bae500000162",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/0ee24723-f640-11e5-8a84-bae500000065/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"consignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/869d7628-6396-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"transportFacilityNumber": "лb777m",
"shippingInstructions": "Беречь от воздействия солнца",
"cargoName": "Овощи",
"transportFacility": "Mercedes benz",
"carrier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/cffd2c81-62b4-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"overhead": {
"sum": 200,
"distribution": "price"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/b44f220c-f64e-11e5-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "b44f220c-f64e-11e5-8a84-bae500000068",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-01 10:37:29",
"name": "00002",
"externalCode": "btlob8zrgFoJoxXLNyxBi3",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-03-30 11:08:00",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 123000,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/850f1667-f504-11e5-8a84-bae500000163/accounts/850f1eab-f504-11e5-8a84-bae500000164",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/b44f220c-f64e-11e5-8a84-bae500000068/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"overhead": {
"sum": 300,
"distribution": "weight"
}
}
]
}
Создать Отгрузку
Запрос на создание новой Отгрузки. Обязательные для создания поля: + name - номер Отгрузки (номер) + organization - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на контрагента (покупателя) в формате Метаданных + store - Ссылка на склад в формате Метаданных
Пример создания новой Отгрузки с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "888",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
}
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/2464c97a-030a-11e6-9464-e4de00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "2464c97a-030a-11e6-9464-e4de00000000",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 16:01:17",
"name": "888",
"externalCode": "Dt7BqCkBhCxUMXayh4NfA2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-15 16:01:17",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 0,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/2464c97a-030a-11e6-9464-e4de00000000/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0
}
Пример создания новой Отгрузки с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "888",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"code": "1243521",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"type": "customerorder",
"mediaType": "application/json"
}
},
"consignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/869d7628-6396-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"transportFacilityNumber": "МК2142",
"shippingInstructions": "Огнеопасно",
"cargoName": "масло",
"transportFacility": "Камаз 2007",
"carrier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/cffd2c81-62b4-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"stateContractId": "s11233dsasd233"
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/c2a04da5-030a-11e6-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "c2a04da5-030a-11e6-9464-e4de00000005",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 16:05:43",
"name": "888",
"code": "1243521",
"externalCode": "p7TPtR1hgOBjUev7rJLmo1",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 0,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/c2a04da5-030a-11e6-9464-e4de00000005/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"stateContractId": "s11233dsasd233"
}
Пример запроса на создание Отгрузки с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "888",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"code": "1243521",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"type": "customerorder",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "23d3965d-0313-11e6-9464-e4de00000097",
"type": "string",
"value": "Весело"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/c2a04da5-030a-11e6-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "c2a04da5-030a-11e6-9464-e4de00000005",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 16:05:43",
"name": "888",
"code": "1243521",
"externalCode": "p7TPtR1hgOBjUev7rJLmo1",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 0,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "23d3965d-0313-11e6-9464-e4de00000097",
"name": "Весёлость отгрузки",
"type": "boolean",
"value": "Весело"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/c2a04da5-030a-11e6-9464-e4de00000005/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0
}
Пример запроса на создание Отгрузки с позициями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "888",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"code": "1243521",
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"positions": [
{
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 10,
"overhead": 20
},
{
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 20,
"overhead": 20
},
{
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "service",
"mediaType": "application/json"
}
},
"pack": {
"id": "1bf22e62-8b47-11e8-56c0-000800000006"
},
"reserve": 30,
"overhead": 20,
"cost": 47
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/c2a04da5-030a-11e6-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "c2a04da5-030a-11e6-9464-e4de00000005",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 16:05:43",
"name": "888",
"code": "1243521",
"externalCode": "p7TPtR1hgOBjUev7rJLmo1",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 0,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/c2a04da5-030a-11e6-9464-e4de00000005/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"overhead": {
"sum": 60,
"distribution": "price"
}
}
Массовое создание и обновление Отгрузок
Массовое создание и обновление Отгрузок. В теле запроса нужно передать массив, содержащий JSON представления Отгрузок, которые вы хотите создать или обновить. Обновляемые Отгрузки должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Отгрузок
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "888",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"name": "887",
"moment": "2004-01-14 19:03:00",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"type": "store",
"mediaType": "application/json"
}
},
"code": "666",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"type": "customerorder",
"mediaType": "application/json"
}
},
"stateContractId": "s11233dsasd233"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Отгрузок.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/2464c97a-030a-11e6-9464-e4de00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "2464c97a-030a-11e6-9464-e4de00000000",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 16:01:17",
"name": "888",
"externalCode": "Dt7BqCkBhCxUMXayh4NfA2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-15 16:01:17",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 0,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/2464c97a-030a-11e6-9464-e4de00000000/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "405f69c0-019e-11e6-9464-e4de00000085",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 16:26:20",
"name": "887",
"code": "666",
"externalCode": "ibWbdtWWhXiIwfZVEal6z2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2004-01-14 19:03:00",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 346389501420,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/51f263f9-0307-11e6-9464-e4de0000007c",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"payedSum": 365939611804,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerOrder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
},
"stateContractId": "s11233dsasd233"
}
]
Удалить Отгрузку
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Отгрузки. |
Запрос на удаление Отгрузки с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Отгрузки.
Метаданные Отгрузок
Метаданные Отгрузок
Запрос на получение метаданных Отгрузок. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Отгрузок + attributes - Массив объектов доп. полей Отгрузок в формате Метаданных + states - Массив статусов Отгрузок + createShared - создавать новые Отгрузки с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Отгрузок
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Отгрузок.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "23d3965d-0313-11e6-9464-e4de00000097",
"name": "Весёлость отгрузки",
"type": "boolean",
"required": false
},
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name2",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "demand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "demand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56cf4f-2e58-11e6-8a84-bae50000006b",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cf4f-2e58-11e6-8a84-bae50000006b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Собран",
"color": 8767198,
"stateType": "Regular",
"entityType": "demand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56d433-2e58-11e6-8a84-bae50000006c",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d433-2e58-11e6-8a84-bae50000006c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отгружен",
"color": 10774205,
"stateType": "Regular",
"entityType": "demand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56d92f-2e58-11e6-8a84-bae50000006d",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d92f-2e58-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Доставлен",
"color": 8825440,
"stateType": "Successful",
"entityType": "demand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56de0a-2e58-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56de0a-2e58-11e6-8a84-bae50000006e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Возврат",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "demand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56e2b4-2e58-11e6-8a84-bae50000006f",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56e2b4-2e58-11e6-8a84-bae50000006f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отменен",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "demand"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/attributes/127d484e-3f81-11e6-8a84-bae5000000cb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "127d484e-3f81-11e6-8a84-bae5000000cb",
"name": "Причина возврата",
"type": "string",
"required": false
}
Шаблон отгрузки
Шаблон отгрузки
Запрос на получение предзаполненого стандартными значениями шаблона отгрузки без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной отгрузки.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/105a788e-36e7-11e7-8a7f-40d000000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/103cca6f-36e7-11e7-8a7f-40d000000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2017-05-12 15:31:10",
"applicable": true,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/1076a96a-36e7-11e7-8a7f-40d000000092",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/107430bc-36e7-11e7-8a7f-40d000000090",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0
}
Шаблон отгрузки на основе
Запрос на получение шаблона отгрузки на основе заказа покупателя или счёта покупателю. В результате запроса, будет создан предзаполненный шаблон отгрузки на основе переданного документа.
Запрос на создание отгрузки на основе заказа покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/451cb4c0-3d1d-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной отгрузки.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 18:02:21",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"rows": [
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c55b5e7c-9128-11e6-8a84-bae500000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/559adab5-915c-11e6-8a84-bae500000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
}
}
Запрос на создание отгрузки на основе счёта покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"invoicesOut": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/1571eb25-d03d-11e7-6a80-332a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#invoiceout/edit?id=1571eb25-d03d-11e7-6a80-332a00000002"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной отгрузки.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/46073d61-ca1f-11e7-6a80-332a0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=46073d61-ca1f-11e7-6a80-332a0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/452fb22f-ca1f-11e7-6a80-332a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "",
"moment": "2017-11-23 13:59:29",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/464062ac-ca1f-11e7-6a80-332a00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=464062ac-ca1f-11e7-6a80-332a00000058"
}
}
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/463f8970-ca1f-11e7-6a80-332a00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=463f8970-ca1f-11e7-6a80-332a00000053"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/463fe231-ca1f-11e7-6a80-332a00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=463fe231-ca1f-11e7-6a80-332a00000056"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/463a706e-ca1f-11e7-6a80-332a00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=463a706e-ca1f-11e7-6a80-332a00000051"
}
},
"documents": {
"rows": []
},
"positions": {
"rows": [
{
"quantity": 1,
"price": 100000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/b5d94dd1-cab0-11e7-6a80-332a00000011",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"invoicesOut": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/1571eb25-d03d-11e7-6a80-332a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoiceout/metadata",
"type": "invoiceout",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#invoiceout/edit?id=1571eb25-d03d-11e7-6a80-332a00000002"
}
}
]
}
Отгрузка
Получить Отгрузку
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Отгрузки. |
Запрос на получение отдельной Отгрузки с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "405f69c0-019e-11e6-9464-e4de00000085",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 15:48:46",
"name": "24124",
"externalCode": "ibWbdtWWhXiIwfZVEal6z2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-14 11:03:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 346389501420,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/bc1b4fde-019a-11e6-9464-e4de00000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 214
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/51f263f9-0307-11e6-9464-e4de0000007c",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"payedSum": 365939611804,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerOrder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
},
"consignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/869d7628-6396-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"transportFacilityNumber": "ло777v",
"shippingInstructions": "Беречь от воздействия солнца",
"cargoName": "Овощи",
"transportFacility": "Mercedes benz",
"goodPackQuantity": 500,
"carrier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/cffd2c81-62b4-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"overhead": {
"sum": 200,
"distribution": "price"
}
}
Изменить Отгрузку
Запрос на обновление Отгрузки с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Отгрузки, кроме тех, что
помечены Только для чтения в описании атрибутов Отгрузки.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Отгрузки. |
Пример запроса на обновление отдельной Отгрузки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "887",
"moment": "2004-01-14 19:03:00",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"type": "store",
"mediaType": "application/json"
}
},
"code": "666",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"type": "customerorder",
"mediaType": "application/json"
}
},
"stateContractId": "s11233dsasd233"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "405f69c0-019e-11e6-9464-e4de00000085",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 16:26:20",
"name": "887",
"code": "666",
"externalCode": "ibWbdtWWhXiIwfZVEal6z2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2004-01-14 19:03:00",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 346389501420,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/51f263f9-0307-11e6-9464-e4de0000007c",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"payedSum": 365939611804,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerOrder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
},
"stateContractId": "s11233dsasd233"
}
Пример запроса на изменение Отгрузки с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "887",
"moment": "2004-01-14 19:03:00",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"type": "store",
"mediaType": "application/json"
}
},
"code": "666",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"type": "customerorder",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "23d3965d-0313-11e6-9464-e4de00000097",
"name": "Весёлость отгрузки",
"type": "boolean",
"value": "Печально"
}
],
"consignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/869d7628-6396-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"transportFacilityNumber": "МК2142",
"shippingInstructions": "Огнеопасно",
"cargoName": "масло",
"transportFacility": "Камаз 2007",
"carrier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/cffd2c81-62b4-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"overhead": {
"sum": 990,
"distribution": "price"
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "405f69c0-019e-11e6-9464-e4de00000085",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 16:26:20",
"name": "887",
"code": "666",
"externalCode": "ibWbdtWWhXiIwfZVEal6z2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2004-01-14 19:03:00",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 346389501420,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/51f263f9-0307-11e6-9464-e4de0000007c",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "23d3965d-0313-11e6-9464-e4de00000097",
"name": "Весёлость отгрузки",
"type": "boolean",
"value": "Грустно"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"payedSum": 365939611804,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerOrder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
},
"consignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/869d7628-6396-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"transportFacilityNumber": "МК2142",
"shippingInstructions": "Огнеопасно",
"cargoName": "масло",
"transportFacility": "Камаз 2007",
"carrier": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/cffd2c81-62b4-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"overhead": {
"sum": 990,
"distribution": "price"
}
}
Пример запроса на обновление Отгрузки с позициями в теле запроса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "887",
"moment": "2004-01-14 19:03:00",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"type": "store",
"mediaType": "application/json"
}
},
"code": "666",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/c49e83b3-01af-11e6-9464-e4de00000026",
"type": "customerorder",
"mediaType": "application/json"
}
},
"positions": [
{
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 10
},
{
"id": "34f6344f-015e-11e6-9464-e4de0000006d",
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 20
},
{
"id": "34f6344f-015e-11e6-9464-e4de0000006e",
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 30
}
],
"overhead": {
"sum": 1000,
"distribution": "weight"
}
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
},
"id": "405f69c0-019e-11e6-9464-e4de00000085",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-15 16:26:20",
"name": "887",
"code": "666",
"externalCode": "ibWbdtWWhXiIwfZVEal6z2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2004-01-14 19:03:00",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 346389501420,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/8ce3c179-015e-11e6-9464-e4de0000007a",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/51f263f9-0307-11e6-9464-e4de0000007c",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/850c8af2-f504-11e5-8a84-bae50000015f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9794d400-f689-11e5-8a84-bae500000078/accounts/9794f7a0-f689-11e5-8a84-bae500000079",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"payedSum": 365939611804,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/34efe2ee-015e-11e6-9464-e4de0000006b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/customerOrder/metadata",
"type": "customerorder",
"mediaType": "application/json"
}
},
"stateContractId": "s11233dsasd233"
}
Позиции Отгрузки
Отдельный ресурс для управления позициями Отгрузки. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Отгрузки
Запрос на получение списка всех позиций данной Отгрузки. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Отгрузки.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Отгрузки. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Отгрузки
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельной Отгрузки.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/40603fbd-019e-11e6-9464-e4de00000086",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "40603fbd-019e-11e6-9464-e4de00000086",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"sum": 123050,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/40604612-019e-11e6-9464-e4de00000087",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "40604612-019e-11e6-9464-e4de00000087",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"sum": 214,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/60fc3826-00d7-11e6-9464-e4de00000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
},
"cost": 34
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/40604a79-019e-11e6-9464-e4de00000088",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "40604a79-019e-11e6-9464-e4de00000088",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"sum": 346347237062,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/56c73633-ffe4-11e5-9464-e4de000000c6/d1bef0a1-ffe7-11e5-9464-e4de0000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"country": {
"name": "Германия"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/406055cb-019e-11e6-9464-e4de00000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "406055cb-019e-11e6-9464-e4de00000089",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"sum": 42141094,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66cc36dc-f7d2-11e5-8a84-bae500000074/671b5330-f7d2-11e5-8a84-bae500000088",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
}
Создать позицию Отгрузки
Запрос на создание новой позиции в Отгрузке. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Отгрузки + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Отгрузки. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Отгрузки. |
Пример создания одной позиции в Отгрузке.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 4,
"price": 12345,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельной Отгрузки.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/3bf025cc-0310-11e6-9464-e4de0000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "3bf025cc-0310-11e6-9464-e4de0000000e",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 4,
"price": 12345,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/66ccbc9f-f7d2-11e5-8a84-bae500000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
Пример создания сразу нескольких позиций в Отгрузке.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 103,
"price": 1002,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 21,
"price": 2300,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 3,
"price": 3500,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "service",
"mediaType": "application/json"
}
},
"pack": {
"id": "1bf22e62-8b47-11e8-56c0-000800000006"
},
"cost": 47
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка созданных позиций отдельной Отгрузки.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/727cf336-0310-11e6-9464-e4de00000013",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "727cf336-0310-11e6-9464-e4de00000013",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/727cfce0-0310-11e6-9464-e4de00000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "727cfce0-0310-11e6-9464-e4de00000014",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/727d057f-0310-11e6-9464-e4de00000015",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "727d057f-0310-11e6-9464-e4de00000015",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/c02e3a5c-007e-11e6-9464-e4de00000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
},
"pack": {
"id": "1bf22e62-8b47-11e8-56c0-000800000006",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/2ec1170c-3f69-4409-87bb-c68e0011b275",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
}
},
"quantity": 2
},
"cost": 47
}
]
Позиция Отгрузки
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Отгрузки. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Отгрузки. |
Запрос на получение отдельной позиции Отгрузки с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/727cfce0-0310-11e6-9464-e4de00000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "727cfce0-0310-11e6-9464-e4de00000014",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 20,
"sum": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Изменить позицию
Запрос на обновление отдельной позиции Отгрузки. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Отгрузки. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Отгрузки. |
Пример запроса на обновление отдельной позиции в Отгрузке.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 111,
"price": 26332700,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Отгрузки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/405f69c0-019e-11e6-9464-e4de00000085/positions/727cfce0-0310-11e6-9464-e4de00000014",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "727cfce0-0310-11e6-9464-e4de00000014",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 111,
"price": 26332700,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Отгрузки. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Отгрузки. |
Запрос на удаление отдельной позиции Отгрузки с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/demand/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Отгрузки.
Документ Приёмка
Средствами JSON API можно создавать и обновлять сведения об Приёмках, запрашивать списки Приёмок и сведения по отдельным Приёмкам. Позициями Приёмок можно управлять как в составе отдельной Приёмки, так и отдельно - с помощью специальных ресурсов для управления позициями Приёмки. Кодом сущности для Приёмки в составе JSON API является ключевое слово supply. Больше об Приёмках и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Приёмки
Атрибуты сущности
- meta - Метаданные об Приёмке
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Приёмки
- description - Комментарий Приёмки
- externalCode - Внешний код Приёмки
- moment - Дата Приёмки
- applicable - Отметка о проведении
- vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- sum - Сумма Приёмки в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- project - Ссылка на проект в формате Метаданных
- state - Статус Приёмки в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения - positions - Ссылка на позиции в Приёмке в формате Метаданных
- overhead - Накладные расходы. Если Позиции Приёмки не заданы, то накладные расходы нельзя задать
- sum - сумма накладных расходов
- distribution - Распределение накладных расходов `
->[по весу, по объёму, по цене]`
- payedSum - Сумма исходящих платежей по приёмке
- incomingNumber - Входящий номер
- incomingDate - Входящая дата #### Связи с другими документами
- purchaseOrder - Ссылка на связанный заказ поставщику в формате Метаданных
- factureIn - Ссылка на Счет-фактура полученный, с которым связана эта Приёмка в формате Метаданных
- invoicesIn - Массив ссылок на связанные счета поставщиков в формате Метаданных
- payments - Массив ссылок на связанные платежи в формате Метаданных
- returns - Массив ссылок на связанные возвраты в формате Метаданных
Позиции Приёмки
Позиции Приёмки - это список товаров/услуг/модификаций/серий.
Объект позиции Приёмки содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ discount - Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10%
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ things - Серийные номера
+ gtd - ГТД
+ country - Ссылка на страну в формате Метаданных
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
С позициями можно работать с помощью специальных ресурсов для управления позициями Приёмки, а также в составе отдельной Приёмки. При работе в составе отдельной Приёмки, вы можете отправлять запросы на создание отдельной Приёмки с включенным в тело запроса массивом позиций Приёмки. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Приёмки". Также, при работе в составе отдельной Приёмки, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Приёмки. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Приёмки" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены. + overhead - Накладные расходы по позиции.
О работе с доп. полями Приёмок можно прочитать здесь
Получить список Приёмок
Запрос всех Приёмок на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Приёмки.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить список Приёмок
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/supply"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Приёмок.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/a3a404e4-2e5d-11e6-8a84-bae5000000fd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "a3a404e4-2e5d-11e6-8a84-bae5000000fd",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-27 10:48:47",
"name": "00001",
"externalCode": "0ULmxwN1jHJwT9nYPawwO2",
"moment": "2016-06-10 09:26:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 16136135600,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf44002-2e58-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/a3a404e4-2e5d-11e6-8a84-bae5000000fd/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"incomingDate": "2016-06-04 00:00:00"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "b1008773-313f-11e6-8a84-bae500000089",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-13 11:20:30",
"name": "00002",
"externalCode": "zDCH0byNj4OtLFybETa560",
"moment": "2016-06-13 11:20:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf44002-2e58-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/f39a60f5-313f-11e6-8a84-bae5000000b4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "f39a60f5-313f-11e6-8a84-bae5000000b4",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-15 12:22:08",
"name": "00003",
"externalCode": "M69h5veIhqsaDAZI88LUy0",
"moment": "2016-06-13 11:21:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 16000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf44002-2e58-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/f39a60f5-313f-11e6-8a84-bae5000000b4/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0
}
]
}
Создать Приёмку
Запрос на создание новой Приёмки. Обязательные для создания поля: + name - номер Приёмки (номер) + organization - Ссылка на ваше юрлицо в формате Метаданных + agent - Ссылка на контрагента (покупателя) в формате Метаданных + store - Ссылка на склад в формате Метаданных
Пример создания новой Приёмки.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/supply"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "404050",
"description": "Приёмка от 12.12.12",
"code": "776762312",
"externalCode": "77sea2as12",
"moment": "2012-12-12 12:12:12",
"applicable": true,
"vatEnabled": false,
"vatIncluded": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 12:12:12"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Приёмки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/f106723d-3f66-11e6-8a84-bae500000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "f106723d-3f66-11e6-8a84-bae500000037",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 11:36:44",
"name": "404050",
"description": "Приёмка от 12.12.12",
"code": "776762312",
"externalCode": "77sea2as12",
"moment": "2012-12-12 11:12:12",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/f106723d-3f66-11e6-8a84-bae500000037/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 11:12:12"
}
Пример запроса на создание Приёмки с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/supply"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "404050124",
"description": "Приёмка от 909090",
"code": "776762312",
"externalCode": "77sea2as12",
"moment": "2016-02-22 22:22:53",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 12:12:12",
"attributes": [
{
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"value": "2017-02-22 02:12:53"
},
{
"id": "c16fd9aa-3f62-11e6-8a84-bae50000007e",
"value": 47
},
{
"id": "c16fe013-3f62-11e6-8a84-bae50000007f",
"value": "Пример удачной сделки"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Приёмки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/ad890c61-3f67-11e6-8a84-bae50000003b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "ad890c61-3f67-11e6-8a84-bae50000003b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 11:42:00",
"name": "404050124",
"description": "Приёмка от 909090",
"code": "776762312",
"externalCode": "77sea2as12",
"moment": "2016-02-22 22:22:53",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/a31685ae-3f62-11e6-8a84-bae50000007b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"name": "Доп. дата",
"type": "time",
"value": "2017-02-22 02:12:53"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fd9aa-3f62-11e6-8a84-bae50000007e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fd9aa-3f62-11e6-8a84-bae50000007e",
"name": "Повторить",
"type": "long",
"value": 47
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fe013-3f62-11e6-8a84-bae50000007f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fe013-3f62-11e6-8a84-bae50000007f",
"name": "Комментарий начальства",
"type": "text",
"value": "Пример удачной сделки"
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/ad890c61-3f67-11e6-8a84-bae50000003b/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 11:12:12"
}
Пример запроса на создание Приёмки с позициями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/supply"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "2000124",
"description": "Приёмка от 909090",
"code": "776762312",
"externalCode": "77sea2as12",
"moment": "2016-02-22 22:22:53",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 12:12:12",
"attributes": [
{
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"value": "2017-02-22 02:12:53"
},
{
"id": "c16fd9aa-3f62-11e6-8a84-bae50000007e",
"value": 47
},
{
"id": "c16fe013-3f62-11e6-8a84-bae50000007f",
"value": "Пример удачной сделки"
}
],
"positions": [
{
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 10
},
{
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 20
}
]
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Приёмки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/5b493f0e-3f68-11e6-8a84-bae500000042",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "5b493f0e-3f68-11e6-8a84-bae500000042",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 11:46:52",
"name": "2000124",
"description": "Приёмка от 909090",
"code": "776762312",
"externalCode": "77sea2as12",
"moment": "2016-02-22 22:22:53",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 5000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/a31685ae-3f62-11e6-8a84-bae50000007b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"name": "Доп. дата",
"type": "time",
"value": "2017-02-22 02:12:53"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fd9aa-3f62-11e6-8a84-bae50000007e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fd9aa-3f62-11e6-8a84-bae50000007e",
"name": "Повторить",
"type": "long",
"value": 47
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fe013-3f62-11e6-8a84-bae50000007f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fe013-3f62-11e6-8a84-bae50000007f",
"name": "Комментарий начальства",
"type": "text",
"value": "Пример удачной сделки"
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/5b493f0e-3f68-11e6-8a84-bae500000042/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 11:12:12",
"overhead": {
"sum": 30,
"distribution": "price"
}
}
Массовое создание и обновление Приёмок
Массовое создание и обновление Приёмок. В теле запроса нужно передать массив, содержащий JSON представления Приёмок, которые вы хотите создать или обновить. Обновляемые Приёмки должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Приёмок
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/supply"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "404050",
"description": "Приёмка от 12.12.12",
"code": "776762312",
"externalCode": "77sea2as12",
"moment": "2012-12-12 12:12:12",
"applicable": true,
"vatEnabled": false,
"vatIncluded": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 12:12:12"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/5b493f0e-3f68-11e6-8a84-bae500000042",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"name": "2000700",
"description": "Приёмка от толстого контрагента",
"code": "1241242ы421",
"externalCode": "keksea2as12",
"moment": "2011-12-12 11:11:11",
"applicable": false,
"vatEnabled": true,
"vatIncluded": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 33
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 12:12:12",
"attributes": [
{
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"value": "2082-02-22 02:12:53"
},
{
"id": "c16fe013-3f62-11e6-8a84-bae50000007f",
"value": "Пример крайне удачной сделки"
}
],
"positions": [
{
"quantity": 101,
"price": 190,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"quantity": 20,
"price": 2,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Приёмок.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/f106723d-3f66-11e6-8a84-bae500000037",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "f106723d-3f66-11e6-8a84-bae500000037",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 11:36:44",
"name": "404050",
"description": "Приёмка от 12.12.12",
"code": "776762312",
"externalCode": "77sea2as12",
"moment": "2012-12-12 11:12:12",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/faf45b9a-2e58-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/f106723d-3f66-11e6-8a84-bae500000037/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 11:12:12"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/5b493f0e-3f68-11e6-8a84-bae500000042",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "5b493f0e-3f68-11e6-8a84-bae500000042",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 11:51:34",
"name": "2000700",
"description": "Приёмка от толстого контрагента",
"code": "1241242ы421",
"externalCode": "keksea2as12",
"moment": "2011-12-12 10:11:11",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 19238,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/a31685ae-3f62-11e6-8a84-bae50000007b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"name": "Доп. дата",
"type": "time",
"value": "2082-02-22 02:12:53"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fd9aa-3f62-11e6-8a84-bae50000007e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fd9aa-3f62-11e6-8a84-bae50000007e",
"name": "Повторить",
"type": "long",
"value": 47
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fe013-3f62-11e6-8a84-bae50000007f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fe013-3f62-11e6-8a84-bae50000007f",
"name": "Комментарий начальства",
"type": "text",
"value": "Пример крайне удачной сделки"
}
],
"vatEnabled": true,
"vatIncluded": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/5b493f0e-3f68-11e6-8a84-bae500000042/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 11:12:12"
}
]
Удалить Приёмку
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приёмки. |
Запрос на удаление Приёмки с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/supply/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Приёмки.
Метаданные Приёмок
Метаданные Приёмок
Запрос на получение метаданных Приёмок. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Приёмок + attributes - Массив объектов доп. полей Приёмок в формате Метаданных + states - Массив статусов Приёмок + createShared - создавать новые Приёмки с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Приёмок
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Приёмок.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/a31685ae-3f62-11e6-8a84-bae50000007b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"name": "Доп. дата",
"type": "time",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fd9aa-3f62-11e6-8a84-bae50000007e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fd9aa-3f62-11e6-8a84-bae50000007e",
"name": "Повторить",
"type": "long",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fe013-3f62-11e6-8a84-bae50000007f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fe013-3f62-11e6-8a84-bae50000007f",
"name": "Комментарий начальства",
"type": "text",
"required": false
}
],
"createShared": false
}
Шаблон приемки
Шаблон приемки
Запрос на получение предзаполненого стандартными значениями шаблона приемки без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/supply/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной приемки.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/46073d61-ca1f-11e7-6a80-332a0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=46073d61-ca1f-11e7-6a80-332a0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/452fb22f-ca1f-11e7-6a80-332a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "",
"moment": "2017-11-22 19:05:33",
"applicable": true,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/463f8970-ca1f-11e7-6a80-332a00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=463f8970-ca1f-11e7-6a80-332a00000053"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/463a706e-ca1f-11e7-6a80-332a00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=463a706e-ca1f-11e7-6a80-332a00000051"
}
},
"documents": {
"rows": []
},
"positions": {
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0
}
Шаблон приемки на основе
Запрос на получение предзаполненной приемки на основе заказа поставщику. В результате запроса, будет создан предзаполненный шаблон приемки на основе переданного заказа поставщику.
Запрос на создание приемки на основе заказа поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/supply/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"purchaseOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной приемки.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/46073d61-ca1f-11e7-6a80-332a0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=46073d61-ca1f-11e7-6a80-332a0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/452fb22f-ca1f-11e7-6a80-332a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "",
"moment": "2017-11-22 16:16:29",
"applicable": true,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/463f8970-ca1f-11e7-6a80-332a00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=463f8970-ca1f-11e7-6a80-332a00000053"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/463a706e-ca1f-11e7-6a80-332a00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=463a706e-ca1f-11e7-6a80-332a00000051"
}
},
"documents": {
"rows": []
},
"positions": {
"rows": [
{
"quantity": 1,
"price": 1000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/b5d94dd1-cab0-11e7-6a80-332a00000011",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"invoicesIn": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/dbf1e704-cf7b-11e7-6a80-332a00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#invoicein/edit?id=dbf1e704-cf7b-11e7-6a80-332a00000000"
}
}
],
"purchaseOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/22b4caaa-3f74-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
}
}
}
Запрос на создание приемки на основе счёта поставщика.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/supply/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"invoicesIn": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/dbf1e704-cf7b-11e7-6a80-332a00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#invoicein/edit?id=dbf1e704-cf7b-11e7-6a80-332a00000000"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной приемки.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/46073d61-ca1f-11e7-6a80-332a0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=46073d61-ca1f-11e7-6a80-332a0000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/452fb22f-ca1f-11e7-6a80-332a00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "",
"moment": "2017-11-22 16:16:29",
"applicable": true,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/463f8970-ca1f-11e7-6a80-332a00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=463f8970-ca1f-11e7-6a80-332a00000053"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/463a706e-ca1f-11e7-6a80-332a00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=463a706e-ca1f-11e7-6a80-332a00000051"
}
},
"documents": {
"rows": []
},
"positions": {
"rows": [
{
"quantity": 1,
"price": 1000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/b5d94dd1-cab0-11e7-6a80-332a00000011",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"invoicesIn": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/dbf1e704-cf7b-11e7-6a80-332a00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/invoicein/metadata",
"type": "invoicein",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#invoicein/edit?id=dbf1e704-cf7b-11e7-6a80-332a00000000"
}
}
]
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/a31685ae-3f62-11e6-8a84-bae50000007b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"name": "Доп. дата",
"type": "time",
"required": false
}
Приёмка
Получить Приёмку
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приёмки. |
Запрос на получение отдельной Приёмки с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/supply/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Приёмки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/a3a404e4-2e5d-11e6-8a84-bae5000000fd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "a3a404e4-2e5d-11e6-8a84-bae5000000fd",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-27 10:48:47",
"name": "00001",
"externalCode": "0ULmxwN1jHJwT9nYPawwO2",
"moment": "2016-06-10 09:26:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 16136135600,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf44002-2e58-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/a3a404e4-2e5d-11e6-8a84-bae5000000fd/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"incomingDate": "2016-06-04 00:00:00"
}
Изменить Приёмку
Запрос на обновление Приёмки с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Приёмки, кроме тех, что
помечены Только для чтения в описании атрибутов Приёмки.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приёмки. |
Пример запроса на обновление отдельной Приёмки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/supply/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "2000700",
"description": "Приёмка от толстого контрагента",
"code": "1241242ы421",
"externalCode": "keksea2as12",
"moment": "2011-12-12 11:11:11",
"applicable": false,
"vatEnabled": true,
"vatIncluded": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 33
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 12:12:12",
"attributes": [
{
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"value": "2082-02-22 02:12:53"
},
{
"id": "c16fe013-3f62-11e6-8a84-bae50000007f",
"value": "Пример крайне удачной сделки"
}
],
"positions": [
{
"quantity": 101,
"price": 190,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"quantity": 20,
"price": 2,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Приёмки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/5b493f0e-3f68-11e6-8a84-bae500000042",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
},
"id": "5b493f0e-3f68-11e6-8a84-bae500000042",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 11:51:34",
"name": "2000700",
"description": "Приёмка от толстого контрагента",
"code": "1241242ы421",
"externalCode": "keksea2as12",
"moment": "2011-12-12 10:11:11",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 19238,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/states/918e5abd-3f66-11e6-8a84-bae500000083",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/a31685ae-3f62-11e6-8a84-bae50000007b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "a31685ae-3f62-11e6-8a84-bae50000007b",
"name": "Доп. дата",
"type": "time",
"value": "2082-02-22 02:12:53"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fd9aa-3f62-11e6-8a84-bae50000007e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fd9aa-3f62-11e6-8a84-bae50000007e",
"name": "Повторить",
"type": "long",
"value": 47
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata/attributes/c16fe013-3f62-11e6-8a84-bae50000007f",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c16fe013-3f62-11e6-8a84-bae50000007f",
"name": "Комментарий начальства",
"type": "text",
"value": "Пример крайне удачной сделки"
}
],
"vatEnabled": true,
"vatIncluded": false,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/5b493f0e-3f68-11e6-8a84-bae500000042/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"incomingNumber": "12412412",
"incomingDate": "2012-12-12 11:12:12"
}
Позиции Приёмки
Отдельный ресурс для управления позициями Приёмки. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Приёмки
Запрос на получение списка всех позиций данной Приёмки. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Приёмки.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приёмки. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Приёмки
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/supply/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельной Приёмки.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions",
"type": "supplyposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions/b100a7fc-313f-11e6-8a84-bae50000008a",
"type": "supplyposition",
"mediaType": "application/json"
},
"id": "b100a7fc-313f-11e6-8a84-bae50000008a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1241,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"gtd": {
"name": "12345678/121217/1212321"
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions/b100b367-313f-11e6-8a84-bae50000008b",
"type": "supplyposition",
"mediaType": "application/json"
},
"id": "b100b367-313f-11e6-8a84-bae50000008b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 700,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"gtd": {
"name": "12345678/121217/1242523"
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
}
Создать позицию Приёмки
Запрос на создание новой позиции в Приёмке. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Приёмки + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Приёмки. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приёмки. |
Пример создания одной позиции в Приёмке.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/supply/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 44,
"price": 700,
"discount": 23,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/000d77a9-3000-4f81-a995-6b9cffdee1d2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"overhead": 300
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельной Приёмки.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions/e33f101b-3f64-11e6-8a84-bae500000025",
"type": "supplyposition",
"mediaType": "application/json"
},
"id": "e33f101b-3f64-11e6-8a84-bae500000025",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 44,
"price": 700,
"discount": 23,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/000d77a9-3000-4f81-a995-6b9cffdee1d2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
Пример создания сразу нескольких позиций в Приёмке.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/supply/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 44,
"price": 700,
"discount": 23,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/000d77a9-3000-4f81-a995-6b9cffdee1d2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"overhead": 300
},
{
"quantity": 3,
"price": 3500,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"quantity": 21,
"price": 2300,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка созданных позиций отдельной Приёмки.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions/3b5fdebd-3f65-11e6-8a84-bae50000002a",
"type": "supplyposition",
"mediaType": "application/json"
},
"id": "3b5fdebd-3f65-11e6-8a84-bae50000002a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 44,
"price": 700,
"discount": 23,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/000d77a9-3000-4f81-a995-6b9cffdee1d2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions/3b5fe7b8-3f65-11e6-8a84-bae50000002b",
"type": "supplyposition",
"mediaType": "application/json"
},
"id": "3b5fe7b8-3f65-11e6-8a84-bae50000002b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 3,
"price": 3500,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions/3b5ffcfd-3f65-11e6-8a84-bae50000002c",
"type": "supplyposition",
"mediaType": "application/json"
},
"id": "3b5ffcfd-3f65-11e6-8a84-bae50000002c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 21,
"price": 2300,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
Позиция Приёмки
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приёмки. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Приёмки. |
Запрос на получение отдельной позиции Приёмки с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/supply/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Приёмки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions/b100a7fc-313f-11e6-8a84-bae50000008a",
"type": "supplyposition",
"mediaType": "application/json"
},
"id": "b100a7fc-313f-11e6-8a84-bae50000008a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1241,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
}
Изменить позицию
Запрос на обновление отдельной позиции Приёмки. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приёмки. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Приёмки. |
Пример запроса на обновление отдельной позиции в Приёмке.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/supply/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 700,
"price": 2355,
"discount": 69,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 2
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Приёмки.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089/positions/3b5ffcfd-3f65-11e6-8a84-bae50000002c",
"type": "supplyposition",
"mediaType": "application/json"
},
"id": "3b5ffcfd-3f65-11e6-8a84-bae50000002c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 700,
"price": 2355,
"discount": 69,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 0
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Приёмки. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Приёмки. |
Запрос на удаление отдельной позиции Приёмки с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/supply/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Приёмки.
Документ Списание
Средствами JSON API можно создавать и обновлять сведения о Списаниях, запрашивать списки Списаний и сведения по отдельным Списаниям. Позициями Списаний можно управлять как в составе отдельного Списания, так и отдельно - с помощью специальных ресурсов для управления позициями Списания. Кодом сущности для Списания в составе JSON API является ключевое слово loss. Больше о Списаниях можно прочитать этой ссылке.
Списания
Атрибуты сущности
- meta - Метаданные о Списании
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Списания
- description - Комментарий Списания
- externalCode - Внешний код Списания
- moment - Дата Списания
- applicable - Отметка о проведении
- sum - Сумма Списания в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- project - Ссылка на проект в формате Метаданных
- state - Статус Списания в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - positions - Ссылка на позиции Списания в формате Метаданных #### Связи с другими документами
- salesReturn - Ссылка на связанный со списанием возврат покупателя в формате Метаданных
Позиции Списания
Позиции Списания - это список товаров/услуг/модификаций/серий.
Объект позиции Списания содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ things - Серийные номера
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
С позициями можно работать с помощью специальных ресурсов для управления позициями Списания, а также в составе отдельного Списания. При работе в составе отдельного Списания, вы можете отправлять запросы на создание отдельного Списания с включенным в тело запроса массивом позиций Списания. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Списания". Также, при работе в составе отдельного Списания, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Списания. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Списания" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены. + reason - Причина списания данной позиции
О работе с доп. полями Списаний можно прочитать здесь
Получить Списания
Запрос всех Списаний на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Списания.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить Списания
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/loss"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Списаний.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/6ddca2d7-4f28-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json"
},
"id": "6ddca2d7-4f28-11e6-8a84-bae500000066",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 15:22:54",
"name": "00001",
"externalCode": "o5GMiWUJhqhq1vmrUWwI-2",
"moment": "2016-07-21 12:49:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 3981730,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0912ad5-4f3d-11e6-8a84-bae500000082",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0912ad5-4f3d-11e6-8a84-bae500000082",
"name": "Процент",
"type": "double",
"value": 0.2
}
],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/6ddca2d7-4f28-11e6-8a84-bae500000066/positions",
"type": "lossposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/9d020efd-4f2a-11e6-8a84-bae500000078",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json"
},
"id": "9d020efd-4f2a-11e6-8a84-bae500000078",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 15:23:02",
"name": "00002",
"externalCode": "08cP74Ftgc7MrBTbGfGVJ3",
"moment": "2016-07-21 13:05:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0912ad5-4f3d-11e6-8a84-bae500000082",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0912ad5-4f3d-11e6-8a84-bae500000082",
"name": "Процент",
"type": "double",
"value": 45.2
}
],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/9d020efd-4f2a-11e6-8a84-bae500000078/positions",
"type": "lossposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
}
]
}
Создать Списание
Запрос на создание нового Списания. Для успешного создания необходимо в теле запроса указать следующие поля:
+ organization - Ссылка на ваше юрлицо в формате Метаданных Необходимое
+ store - Ссылка на склад в формате Метаданных Необходимое
Пример создания нового Списания.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/loss"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b72f4f02-9b8b-11e6-8af5-581e0000009b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 23,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 12,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/987d77f1-9a09-11e6-8af5-581e00000074",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Списания.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json"
},
"id": "b014dab4-4f42-11e6-8a84-bae500000006",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 15:57:32",
"name": "00005",
"externalCode": "itqCvT69hgSZFTJEL9cP70",
"moment": "2016-07-21 15:57:32",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 50000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006/positions",
"type": "lossposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
}
Массовое создание и обновление Списаний
Массовое создание и обновление Списаний. В теле запроса нужно передать массив, содержащий JSON представления Списаний, которые вы хотите создать или обновить. Обновляемые Списания должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Списаний
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/loss"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b72f4f02-9b8b-11e6-8af5-581e0000009b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 23,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 12,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/987d77f1-9a09-11e6-8af5-581e00000074",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json"
},
"name": "00606234",
"externalCode": "3498142кук",
"moment": "2016-07-21 15:57:32",
"applicable": true,
"sum": 50000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": [],
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Списаний.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json"
},
"id": "b014dab4-4f42-11e6-8a84-bae500000006",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 15:57:32",
"name": "00005",
"externalCode": "itqCvT69hgSZFTJEL9cP70",
"moment": "2016-07-21 15:57:32",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 50000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006/positions",
"type": "lossposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json"
},
"id": "b014dab4-4f42-11e6-8a84-bae500000006",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 16:05:11",
"name": "00606234",
"externalCode": "3498142кук",
"moment": "2016-07-21 15:57:32",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006/positions",
"type": "lossposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
}
]
Удалить Списание
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Списания. |
Запрос на удаление Списания с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/loss/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Списания.
Метаданные Списаний
Метаданные Списаний
Запрос на получение метаданных Списаний. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Списаний + attributes - Массив объектов доп. полей Списаний в формате Метаданных + states - Массив статусов Списаний + createShared - создавать новые Списания с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Списаний
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных Списаний.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0911efc-4f3d-11e6-8a84-bae500000081",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0911efc-4f3d-11e6-8a84-bae500000081",
"name": "Строковое поле",
"type": "string",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0912ad5-4f3d-11e6-8a84-bae500000082",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0912ad5-4f3d-11e6-8a84-bae500000082",
"name": "Процент",
"type": "double",
"required": true
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0912ad5-4f3d-11e6-8a84-bae500000082",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0912ad5-4f3d-11e6-8a84-bae500000082",
"name": "Процент",
"type": "double",
"required": true
}
Шаблон списания
Шаблон списания
Запрос на получение предзаполненого стандартными значениями шаблона списания без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/loss/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного списания.
{
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "lossposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
},
"rows": []
}
}
Шаблон списания на основе
Запрос на получение предзаполненного списания на основе возврата покупателя. В результате запроса, будет создан предзаполненный шаблон списания на основе переданного возврата покупателя.
Пример с заказом (application/json)
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/loss/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного списания.
{
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 28000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "lossposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"type": "lossposition",
"mediaType": "application/json"
},
"quantity": 1,
"price": 20000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"type": "lossposition",
"mediaType": "application/json"
},
"quantity": 1,
"price": 10000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"type": "lossposition",
"mediaType": "application/json"
},
"quantity": 1,
"price": 20000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
},
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/166909e6-4a99-11e6-8a84-bae500000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
}
Списание
Получить Списание
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Списания. |
Запрос на получение отдельного списания с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/loss/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Списания.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/6ddca2d7-4f28-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json"
},
"id": "6ddca2d7-4f28-11e6-8a84-bae500000066",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 15:22:54",
"name": "00001",
"externalCode": "o5GMiWUJhqhq1vmrUWwI-2",
"moment": "2016-07-21 12:49:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/cdbc62de-3f68-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63
},
"sum": 3981730,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0912ad5-4f3d-11e6-8a84-bae500000082",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0912ad5-4f3d-11e6-8a84-bae500000082",
"name": "Процент",
"type": "double",
"value": 0.2
}
],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/6ddca2d7-4f28-11e6-8a84-bae500000066/positions",
"type": "lossposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Изменить Списание
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Списания. |
Запрос на обновление списания с указанным id.
Пример запроса на обновление отдельного Списания.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/loss/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "00606234",
"externalCode": "3498142кук",
"moment": "2016-07-21 15:57:32",
"applicable": true,
"sum": 50000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": [],
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Списания.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json"
},
"id": "b014dab4-4f42-11e6-8a84-bae500000006",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 16:05:11",
"name": "00606234",
"externalCode": "3498142кук",
"moment": "2016-07-21 15:57:32",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006/positions",
"type": "lossposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
}
Пример запроса на изменение Списания с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/loss/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "00606234",
"externalCode": "3498142кук",
"moment": "2016-07-21 15:57:32",
"applicable": true,
"sum": 50000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"positions": [],
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0912ad5-4f3d-11e6-8a84-bae500000082",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0912ad5-4f3d-11e6-8a84-bae500000082",
"name": "Процент",
"value": 0.7643
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0911efc-4f3d-11e6-8a84-bae500000081",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0911efc-4f3d-11e6-8a84-bae500000081",
"name": "Строковое поле",
"value": "Строковое значение"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Списания.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata",
"type": "loss",
"mediaType": "application/json"
},
"id": "b014dab4-4f42-11e6-8a84-bae500000006",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 16:05:11",
"name": "00606234",
"externalCode": "3498142кук",
"moment": "2016-07-21 15:57:32",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0911efc-4f3d-11e6-8a84-bae500000081",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0911efc-4f3d-11e6-8a84-bae500000081",
"name": "Строковое поле",
"type": "string",
"value": "Строковое значение"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/metadata/attributes/d0912ad5-4f3d-11e6-8a84-bae500000082",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "d0912ad5-4f3d-11e6-8a84-bae500000082",
"name": "Процент",
"type": "double",
"value": 0.7643
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/b014dab4-4f42-11e6-8a84-bae500000006/positions",
"type": "lossposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"salesReturn": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
}
}
}
Позиции Списания
Отдельный ресурс для управления позициями Списания. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Списания
Запрос на получение списка всех позиций данного Списания. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Списания.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Списания. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Списания
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/loss/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного Списания.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions",
"type": "lossposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions/0b615a22-4f42-11e6-8a84-bae50000008e",
"type": "lossposition",
"mediaType": "application/json"
},
"id": "0b615a22-4f42-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 2,
"price": 20000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions/0b61605f-4f42-11e6-8a84-bae50000008f",
"type": "lossposition",
"mediaType": "application/json"
},
"id": "0b61605f-4f42-11e6-8a84-bae50000008f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 6,
"price": 10000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions/0b616604-4f42-11e6-8a84-bae500000090",
"type": "lossposition",
"mediaType": "application/json"
},
"id": "0b616604-4f42-11e6-8a84-bae500000090",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 33000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
Создать позицию Списания
Запрос на создание новой позиции в Списании. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Списания + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Списания. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Списания. |
Пример создания позиций в Списании.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/loss/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions/0b615a22-4f42-11e6-8a84-bae50000008e",
"type": "lossposition",
"mediaType": "application/json"
},
"quantity": 321,
"price": 53000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "поломка"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions/0b615a22-4f42-11e6-8a84-bae50000008e",
"type": "lossposition",
"mediaType": "application/json"
},
"quantity": 12,
"price": 2645,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "брак"
}
]
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного Списания.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions/d496af06-4f45-11e6-8a84-bae500000033",
"type": "lossposition",
"mediaType": "application/json"
},
"id": "d496af06-4f45-11e6-8a84-bae500000033",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 321,
"price": 53000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "поломка"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions/d496b95b-4f45-11e6-8a84-bae500000034",
"type": "lossposition",
"mediaType": "application/json"
},
"id": "d496b95b-4f45-11e6-8a84-bae500000034",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 12,
"price": 2645,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "брак"
}
]
Позиция Списания
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Списания. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции. |
Запрос на получение отдельной позиции Списания с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/loss/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Списания.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions/0b615a22-4f42-11e6-8a84-bae50000008e",
"type": "lossposition",
"mediaType": "application/json"
},
"id": "0b615a22-4f42-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 2,
"price": 20000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Изменить позицию
Запрос на обновление отдельной позиции Списания. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Списания. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции. |
Пример запроса на обновление отдельной позиции в Списании.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/loss/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 172,
"price": 7777,
"reason": "Разорван"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Списания.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/loss/0b614a51-4f42-11e6-8a84-bae50000008c/positions/d496af06-4f45-11e6-8a84-bae500000033",
"type": "lossposition",
"mediaType": "application/json"
},
"id": "d496af06-4f45-11e6-8a84-bae500000033",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 172,
"price": 7777,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reason": "Разорван"
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Списания. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции. |
Запрос на удаление отдельной позиции Списания с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/loss/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Списания.
Документ Перемещение
Средствами JSON API можно создавать и обновлять сведения о Перемещениях, запрашивать списки Перемещений и сведения по отдельным Перемещениям. Позициями Перемещений можно управлять как в составе отдельного Перемещения, так и отдельно - с помощью специальных ресурсов для управления позициями Перемещения. Кодом сущности для Перемещения в составе JSON API является ключевое слово move.
Перемещения
Атрибуты сущности
- meta - Метаданные о Перемещении
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Перемещения
Необходимое - description - Комментарий Перемещения
- externalCode - Внешний код Перемещения
- moment - Дата Перемещение
- applicable - Отметка о проведении
- sum - Сумма Перемещения в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - project - Ссылка на проект в формате Метаданных
- state - Статус Перемещения в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - positions - Ссылка на позиции в Перемещении в формате Метаданных
- overhead - Накладные расходы
- sum - сумма накладных расходов
- distribution - Распределение накладных расходов `
->[по весу, по объёму, по цене]`
- sourceStore - Ссылка на склад, с которого совершается перемещение, в формате Метаданных
Необходимое - targetStore - Ссылка на склад, на который совершается перемещение, в формате Метаданных
Необходимое - internalOrder - Ссылка на внутренний заказ, связанный с перемещением, в формате Метаданных
Позиции Перемещения
Позиции Перемещения - это список товаров/услуг/модификаций/серий.
Объект позиции Перемещения содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ things - Серийные номера
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
С позициями можно работать с помощью специальных ресурсов для управления позициями Перемещения, а также в составе отдельного Перемещения. При работе в составе отдельного Перемещения, вы можете отправлять запросы на создание отдельного Перемещения с включенным в тело запроса массивом позиций Перемещения. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Перемещения". Также, при работе в составе отдельного Перемещения, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Перемещения. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Перемещения" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены. + overhead - Накладные расходы
О работе с доп. полями Перемещений можно прочитать здесь
Получить Перемещения
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить Перемещения
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/move"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Перемещений.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"id": "5ac52c9a-4f67-11e6-8a84-bae500000084",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 20:20:19",
"name": "00002",
"externalCode": "Avqi0FZqi8W400cwO1oHh2",
"moment": "2016-07-21 20:19:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/states/64c4689e-4f67-11e6-8a84-bae5000000b5",
"type": "state",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 15,
"limit": 1000,
"offset": 0
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/ec94d9ff-4f64-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"id": "ec94d9ff-4f64-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 20:02:36",
"name": "00001",
"externalCode": "l7eb7QKZj1DtnXCLBuuUa1",
"moment": "2016-07-21 19:37:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/ec94d9ff-4f64-11e6-8a84-bae500000069/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}
]
}
Создать Перемещение
Запрос на создание нового Перемещения
Пример создания нового Перемещения с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/move"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Перемещения.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"id": "544236cb-4f6a-11e6-8a84-bae500000003",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2007-02-07 17:16:41",
"name": "705",
"externalCode": "vosdjnodsfne3124pasf",
"moment": "2016-07-21 15:44:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/states/64c4689e-4f67-11e6-8a84-bae5000000b5",
"type": "state",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}
Массовое создание и обновление Перемещений
Массовое создание и обновление Перемещений. В теле запроса нужно передать массив, содержащий JSON представления Перемещений, которые вы хотите создать или обновить. Обновляемые Перемещения должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Перемещений
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/move"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"name": "705507",
"description": "Переезд 2",
"code": "kek",
"externalCode": "moveMOVEMOVE",
"moment": "2016-07-21 19:44:33",
"applicable": false,
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/states/64c4689e-4f67-11e6-8a84-bae5000000b5",
"type": "state",
"mediaType": "application/json"
}
},
"overhead": {
"sum": 5555,
"distribution": "weight"
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/954d6ab9-4f67-11e6-8a84-bae5000000bc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "954d6ab9-4f67-11e6-8a84-bae5000000bc",
"name": "Кол-во машин",
"value": 43
}
],
"positions": []
}
]
'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Перемещений.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"id": "544236cb-4f6a-11e6-8a84-bae500000003",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2007-02-07 17:16:41",
"name": "705",
"externalCode": "vosdjnodsfne3124pasf",
"moment": "2016-07-21 15:44:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/states/64c4689e-4f67-11e6-8a84-bae5000000b5",
"type": "state",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"id": "544236cb-4f6a-11e6-8a84-bae500000003",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 20:44:20",
"name": "705507",
"description": "Переезд 2",
"code": "kek",
"externalCode": "moveMOVEMOVE",
"moment": "2016-07-21 19:44:33",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/states/64c4689e-4f67-11e6-8a84-bae5000000b5",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/954d62cc-4f67-11e6-8a84-bae5000000bb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "954d62cc-4f67-11e6-8a84-bae5000000bb",
"name": "Запрос от",
"type": "time",
"value": "2016-07-21 20:28:53"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/954d6ab9-4f67-11e6-8a84-bae5000000bc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "954d6ab9-4f67-11e6-8a84-bae5000000bc",
"name": "Кол-во машин",
"type": "long",
"value": 43
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}
]
Удалить Перемещение
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
Запрос на удаление Перемещения с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Перемещения.
Шаблон перемещения
Шаблон перемещения
Запрос на получение предзаполненого стандартными значениями шаблона перемещения без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/move/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного перемещения.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 18:02:50",
"applicable": true,
"sum": 0,
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"rows": []
}
}
Шаблон перемещения на основе
Запрос на получение предзаполненного шаблона перемещения на основе внутреннего заказа. В ответ на запрос вернётся предзаполненный шаблон перемещения, который затем можно будет использовать для создания нового перемещения с помощью POST запроса.
Пример запроса на получение шаблона перемещения на основе внутреннего заказа.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/move/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"internalOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного перемещения.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 18:02:21",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 9910,
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"rows": [
{
"quantity": 1,
"price": 2230,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"quantity": 1,
"price": 100,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"quantity": 2,
"price": 500,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"quantity": 3,
"price": 2230,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"internalOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
}
}
}
Метаданные Перемещений
Метаданные Перемещений
Запрос на получение метаданных Перемещений. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Перемещений + attributes - Массив объектов доп. полей Перемещений в формате Метаданных + states - Массив статусов Перемещений + createShared - создавать новые Перемещения с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Перемещений
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/move/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных Перемещений.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/954d62cc-4f67-11e6-8a84-bae5000000bb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "954d62cc-4f67-11e6-8a84-bae5000000bb",
"name": "Запрос от",
"type": "time",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/954d6ab9-4f67-11e6-8a84-bae5000000bc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "954d6ab9-4f67-11e6-8a84-bae5000000bc",
"name": "Кол-во машин",
"type": "long",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/states/64c4689e-4f67-11e6-8a84-bae5000000b5",
"type": "state",
"mediaType": "application/json"
},
"id": "64c4689e-4f67-11e6-8a84-bae5000000b5",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Kek",
"color": 10066329,
"stateType": "Regular",
"entityType": "move"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/954d6ab9-4f67-11e6-8a84-bae5000000bc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "954d6ab9-4f67-11e6-8a84-bae5000000bc",
"name": "Кол-во машин",
"type": "long",
"required": false
}
Перемещение
Получить Перемещение
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
Запрос на получение отдельного Перемещения с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Перемещения.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"id": "5ac52c9a-4f67-11e6-8a84-bae500000084",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 20:20:19",
"name": "00002",
"externalCode": "Avqi0FZqi8W400cwO1oHh2",
"moment": "2016-07-21 20:19:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/states/64c4689e-4f67-11e6-8a84-bae5000000b5",
"type": "state",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 15,
"limit": 1000,
"offset": 0
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}
Изменить Перемещение
Запрос на обновление Перемещения с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
Пример запроса на обновление отдельного Перемещения.
shell curl -X PUT "https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19" -H "Authorization: Basic <Access-Token>" -H "Content-Type: application/json" -d '{ "name": "705507", "description": "Переезд 2", "code": "kek", "externalCode": "moveMOVEMOVE", "moment": "2016-07-21 19:44:33", "applicable": false, "state": { "meta": { "href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/states/64c4689e-4f67-11e6-8a84-bae5000000b5", "type": "state", "mediaType": "application/json" } }, "overhead": { "sum": 5555, "distribution": "weight" }, "organization": { "meta": { "href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e", "metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata", "type": "organization", "mediaType": "application/json" } }, "targetStore": { "meta": { "href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050", "metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata", "type": "store", "mediaType": "application/json" } }, "sourceStore": { "meta": { "href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066", "metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata", "type": "store", "mediaType": "application/json" } }, "attributes": [ { "meta": { "href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/954d6ab9-4f67-11e6-8a84-bae5000000bc", "type": "attributemetadata", "mediaType": "application/json" }, "id": "954d6ab9-4f67-11e6-8a84-bae5000000bc", "name": "Кол-во машин", "value": 43 } ], "positions": [] }'Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Перемещения.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
},
"id": "544236cb-4f6a-11e6-8a84-bae500000003",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-21 20:44:20",
"name": "705507",
"description": "Переезд 2",
"code": "kek",
"externalCode": "moveMOVEMOVE",
"moment": "2016-07-21 19:44:33",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/states/64c4689e-4f67-11e6-8a84-bae5000000b5",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/954d62cc-4f67-11e6-8a84-bae5000000bb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "954d62cc-4f67-11e6-8a84-bae5000000bb",
"name": "Запрос от",
"type": "time",
"value": "2016-07-21 20:28:53"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata/attributes/954d6ab9-4f67-11e6-8a84-bae5000000bc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "954d6ab9-4f67-11e6-8a84-bae5000000bc",
"name": "Кол-во машин",
"type": "long",
"value": 43
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"sourceStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e94a6e65-4f64-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"targetStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
}
}
Позиции Перемещения
Отдельный ресурс для управления позициями Перемещения. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции
Запрос на получение списка всех позиций данного Перемещения. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Перемещения.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить позиции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного Перемещения.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions",
"type": "moveposition",
"mediaType": "application/json",
"size": 15,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac5407b-4f67-11e6-8a84-bae500000085",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac5407b-4f67-11e6-8a84-bae500000085",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 2,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e6447ee7-3303-11e6-8a84-bae5000149c2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac54d7a-4f67-11e6-8a84-bae500000086",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac54d7a-4f67-11e6-8a84-bae500000086",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 3,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e6475862-3303-11e6-8a84-bae5000149cc",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac55815-4f67-11e6-8a84-bae500000087",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac55815-4f67-11e6-8a84-bae500000087",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 4,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e84aed23-3303-11e6-8a84-bae500014dcd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac56175-4f67-11e6-8a84-bae500000088",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac56175-4f67-11e6-8a84-bae500000088",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 5,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e84e52e5-3303-11e6-8a84-bae500014dd7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac56a34-4f67-11e6-8a84-bae500000089",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac56a34-4f67-11e6-8a84-bae500000089",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 2,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8530f64-3303-11e6-8a84-bae500014de6",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac572cd-4f67-11e6-8a84-bae50000008a",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac572cd-4f67-11e6-8a84-bae50000008a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac57b59-4f67-11e6-8a84-bae50000008b",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac57b59-4f67-11e6-8a84-bae50000008b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 32,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0744d71b-2e59-11e6-8a84-bae50000007f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac5843a-4f67-11e6-8a84-bae50000008c",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac5843a-4f67-11e6-8a84-bae50000008c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 14,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a7daa6b-3c64-11e6-8a84-bae50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac58ea6-4f67-11e6-8a84-bae50000008d",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac58ea6-4f67-11e6-8a84-bae50000008d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 5,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a81082f-3c64-11e6-8a84-bae50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac596ca-4f67-11e6-8a84-bae50000008e",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac596ca-4f67-11e6-8a84-bae50000008e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 6,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/7a83c422-3c64-11e6-8a84-bae500000012",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac59eb7-4f67-11e6-8a84-bae50000008f",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac59eb7-4f67-11e6-8a84-bae50000008f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 34,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f05a1f2-3304-11e6-8a84-bae50001c687",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac5a711-4f67-11e6-8a84-bae500000090",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac5a711-4f67-11e6-8a84-bae500000090",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 32,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac5af07-4f67-11e6-8a84-bae500000091",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac5af07-4f67-11e6-8a84-bae500000091",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 12,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f918196-3304-11e6-8a84-bae50001c6d2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac5c872-4f67-11e6-8a84-bae500000092",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac5c872-4f67-11e6-8a84-bae500000092",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 43,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f2a0659-3304-11e6-8a84-bae50001c6a1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac5d0e5-4f67-11e6-8a84-bae500000093",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac5d0e5-4f67-11e6-8a84-bae500000093",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 32,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/27eba7b5-3303-11e6-8a84-bae500002b72",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
}
Создать позицию
Запрос на создание новой позиции в Перемещении. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Перемещения + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Перемещения. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
Пример создания позиций в Перемещении.
shell curl -X POST "https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19/positions" -H "Authorization: Basic <Access-Token>" -H "Content-Type: application/json" -d '[ { "quantity": 43, "price": 670, "assortment": { "meta": { "href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f2a0659-3304-11e6-8a84-bae50001c6a1", "metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata", "type": "product", "mediaType": "application/json" } }, "overhead": 70 }, { "quantity": 32, "price": 640, "assortment": { "meta": { "href": "https://online.moysklad.ru/api/remap/1.2/entity/product/27eba7b5-3303-11e6-8a84-bae500002b72", "metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata", "type": "product", "mediaType": "application/json" } }, "overhead": 65 } ]'Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного Перемещения.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003/positions/476d9c48-4f6b-11e6-8a84-bae500000013",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "476d9c48-4f6b-11e6-8a84-bae500000013",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 43,
"price": 670,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f2a0659-3304-11e6-8a84-bae50001c6a1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003/positions/476da9ce-4f6b-11e6-8a84-bae500000014",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "476da9ce-4f6b-11e6-8a84-bae500000014",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 32,
"price": 640,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/27eba7b5-3303-11e6-8a84-bae500002b72",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
}
]
Позиция Перемещения
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
Запрос на получение отдельной позиции Перемещения с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Перемещения.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/5ac52c9a-4f67-11e6-8a84-bae500000084/positions/5ac55815-4f67-11e6-8a84-bae500000087",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "5ac55815-4f67-11e6-8a84-bae500000087",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 4,
"price": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e84aed23-3303-11e6-8a84-bae500014dcd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
}
Изменить позицию
Запрос на обновление отдельной позиции Перемещения. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
Пример запроса на обновление отдельной позиции в Перемещении.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 44,
"price": 222222
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Перемещения.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/544236cb-4f6a-11e6-8a84-bae500000003/positions/476d9c48-4f6b-11e6-8a84-bae500000013",
"type": "moveposition",
"mediaType": "application/json"
},
"id": "476d9c48-4f6b-11e6-8a84-bae500000013",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 44,
"price": 222222,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f2a0659-3304-11e6-8a84-bae50001c6a1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"overhead": 0
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Перемещения. |
Запрос на удаление отдельной позиции Перемещения с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/move/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Перемещения.
Документ Розничная продажа
Средствами JSON API можно создавать и обновлять сведения о Розничных продажах, запрашивать списки Розничных продаж и сведения по отдельным Розничным продажам. Позициями Розничных продаж можно управлять как в составе отдельной Розничной продажи, так и отдельно - с помощью специальных ресурсов для управления позициями Розничными продажами. Кодом сущности для Розничной продажи в составе JSON API является ключевое слово retaildemand. Больше о Розничных продажах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке в разделе Оформление продажи.
Розничные продажи
Атрибуты сущности
- meta - Метаданные о Розничной продаже
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Розничной продажи
- description - Комментарий Розничной продажи
- externalCode - Внешний код Розничной продажи
- moment - Дата Розничной продажи
- applicable - Отметка о проведении
- vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- sum - Сумма Розничной продажи в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
- agent - Ссылка на контрагента в формате Метаданных
- store - Ссылка на склад в формате Метаданных
- contract - Ссылка на договор в формате Метаданных
- project - Ссылка на проект в формате Метаданных
- state - Статус Розничной продажи в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
- documents - Список печатных форм в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения - positions - Ссылка на позиции Розничной продажи в формате Метаданных
- fiscalPrinterInfo - Информация о фискальном регистраторе
- documentNumber - Номер документа
- checkNumber - Номер чека
- checkSum - Сумма Чека
- fiscal - Отметка о том, был ли использован ФР
Только для чтения - sessionNumber - Номер сессии
- ofdCode -Код оператора фискальных данных
- payedSum - Сумма входящих платежей по Розничной продаже
Только для чтения - retailStore - Ссылка на точку продаж в формате Метаданных
- customerOrder - Ссылка на Заказ Покупателя, с которым связана эта Розничная продажа в формате Метаданных
- retailShift - Ссылка на Розничную смену, в рамках которой была проведена продажа в формате Метаданных
Необходимое - cashSum - Оплачено наличными
- noCashSum - Оплачено картой
Позиции Розничной продажи
Позиции Розничной продажи - это список товаров/услуг/модификаций/серий.
Объект позиции Розничной продажи содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ discount - Процент скидки или наценки. Наценка указывается отрицательным числом, т.е. -10 создаст наценку в 10%
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ things - Серийные номера
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
+ cost - Себестоимость (только для услуг)
С позициями можно работать с помощью специальных ресурсов для управления позициями Розничной продажи, а также в составе отдельной Розничной продажи. При работе в составе отдельной Розничной продажи, вы можете отправлять запросы на создание отдельной Розничной продажи с включенным в тело запроса массивом позиций Розничной продажи. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Розничной продажи". Также, при работе в составе отдельной Розничной продажи, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Розничной продажи. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Розничной продажи" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Розничных продаж можно прочитать здесь
Получить Розничные продажи
Запрос всех Розничных продаж на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Розничные продажи.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Розничные продажи
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Розничных продаж.
{
"context": {
"employee": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/",
"type": "retaildemand",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "0b71daec-055e-11e6-9464-e4de0000007e",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-18 15:06:55",
"name": "00001",
"externalCode": "wxMDIT3-gAn3dmPrr451P0",
"owner": {
"name": "Администратор"
},
"shared": false,
"group": {
"name": "Основной"
},
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"moment": "2016-04-18 15:06:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 5100,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscal": false,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 5100,
"noCashSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/cdccba00-0563-11e6-9464-e4de00000090",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "cdccba00-0563-11e6-9464-e4de00000090",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-18 15:48:09",
"name": "00002",
"externalCode": "ctnglspQg2UGQ388P4pzY3",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"syncId": "d8996a1c-e7ea-470a-994f-a82fdf3190e5",
"moment": "2016-04-18 15:48:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 1800,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/cdccba00-0563-11e6-9464-e4de00000090/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscal": false,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/cd86df19-0563-11e6-9464-e4de0000008e",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 0,
"noCashSum": 1800
}
]
}
Создать Розничную продажу
Розничная смена, на которую указывает ссылка при создании Розничной продажи обязательно должна быть активной. При создании Розничной продажи через JSON API, дата, указанная в moment продажи должна быть позже даты, указанной в moment активной розничной смены, иначе произойдёт ошибка. Также, если вы указываете поля cashSum и noCashSum их сумма должна совпадать с суммой по Розничной продаже (т.е. с суммарной стоимостью всех переданных вами позиций). Обязательные поля при создании новой Розничной продажи: + name - Номер продажи + retailShift - Сссылка на Розничную смену, в рамках которой происходит продажа
Пример создания новой Розничной продажи с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"name": "666dem"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Розничной продажи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/fb5cbcba-0c4e-11e6-9464-e4de00000000",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "fb5cbcba-0c4e-11e6-9464-e4de00000000",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 11:06:44",
"name": "666dem",
"externalCode": "zyOXI-sjg98Ns7iwAA2Pe2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-27 11:06:44",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 0,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/fb5cbcba-0c4e-11e6-9464-e4de00000000/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscal": false,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 0,
"noCashSum": 0
}
Пример создания новой Розничной продажи с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"name": "666demand",
"code": "fuuuuCode1",
"externalCode": "sd1wqsfa2qas",
"moment": "2016-04-27 13:06:44",
"applicable": true,
"sum": 200,
"payedSum": 200,
"fiscal": true,
"fiscalPrinterInfo": "The freaking best FiscalPrinter ever!!",
"documentNumber": 39,
"checkNumber": 124421,
"checkSum": 200,
"sessionNumber": 251251,
"ofdCode": 13
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Розничной продажи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/debee00e-0c59-11e6-9464-e4de00000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "debee00e-0c59-11e6-9464-e4de00000008",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 12:24:40",
"name": "666demand",
"code": "fuuuuCode1",
"externalCode": "sd1wqsfa2qas",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-27 13:06:44",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 0,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/debee00e-0c59-11e6-9464-e4de00000008/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscalPrinterInfo": "The freaking best FiscalPrinter ever!!",
"documentNumber": 39,
"checkNumber": 124421,
"checkSum": 200,
"fiscal": true,
"sessionNumber": 13,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 0,
"noCashSum": 0
}
Пример запроса на создание Розничной продажи с позициями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"name": "666demansd",
"code": "fuuuuCodfe1",
"externalCode": "sd1wqsfa2qas",
"moment": "2016-04-27 13:06:44",
"applicable": true,
"sum": 200,
"payedSum": 200,
"fiscal": true,
"fiscalPrinterInfo": "The freaking best FiscalPrinter ever!!",
"documentNumber": 39,
"checkNumber": 124421,
"checkSum": 200,
"sessionNumber": 251251,
"ofdCode": 13,
"positions": [
{
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "service",
"mediaType": "application/json"
}
},
"cost": 130
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Розничной продажи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/2ef43ba7-0c5a-11e6-9464-e4de0000000c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "2ef43ba7-0c5a-11e6-9464-e4de0000000c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 12:26:55",
"name": "666demansd",
"code": "fuuuuCodfe1",
"externalCode": "sd1wqsfa2qas",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-27 13:06:44",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 14000,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/2ef43ba7-0c5a-11e6-9464-e4de0000000c/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscalPrinterInfo": "The freaking best FiscalPrinter ever!!",
"documentNumber": 39,
"checkNumber": 124421,
"checkSum": 200,
"fiscal": true,
"sessionNumber": 13,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 14000,
"noCashSum": 0
}
Пример запроса на создание Розничной продажи с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"name": "666demansd",
"code": "fuuuuCodfe1",
"externalCode": "sd1wqsfa2qas",
"moment": "2016-04-27 13:06:44",
"applicable": true,
"sum": 200,
"payedSum": 200,
"fiscal": true,
"fiscalPrinterInfo": "The freaking best FiscalPrinter ever!!",
"documentNumber": 39,
"checkNumber": 124421,
"checkSum": 200,
"sessionNumber": 251251,
"ofdCode": 13,
"positions": [
{
"quantity": 10,
"price": 100,
"discount": 0,
"vat": 0,
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 20,
"price": 200,
"discount": 0,
"vat": 21,
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 30,
"price": 300,
"discount": 0,
"vat": 7,
"product": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"attributes": [
{
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"value": "Веселый атрибут"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Розничной продажи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/d6dd9a8a-0c5a-11e6-9464-e4de00000016",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "d6dd9a8a-0c5a-11e6-9464-e4de00000016",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 12:31:37",
"name": "666demansd",
"code": "fuuuuCodfe1",
"externalCode": "sd1wqsfa2qas",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-27 13:06:44",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 14000,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/d6dd9a8a-0c5a-11e6-9464-e4de00000016/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscalPrinterInfo": "The freaking best FiscalPrinter ever!!",
"documentNumber": 39,
"checkNumber": 124421,
"checkSum": 200,
"fiscal": true,
"sessionNumber": 13,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 14000,
"noCashSum": 0
}
Массовое создание и обновление Розничных продаж
Массовое создание и обновление Розничных продаж. В теле запроса нужно передать массив, содержащий JSON представления Розничных продаж, которые вы хотите создать или обновить. Обновляемые Розничные продажи должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Розничных продаж
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"name": "666dem"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/d6dd9a8a-0c5a-11e6-9464-e4de00000016",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"name": "100500_200_300",
"moment": "2016-04-30 13:06:42",
"applicable": false,
"sum": 32402222220,
"payedSum": 23622200,
"fiscal": false,
"fiscalPrinterInfo": "The freaking worst FiscalPrinter ever!!",
"documentNumber": 3,
"checkNumber": 1221,
"checkSum": 1,
"sessionNumber": 251251,
"ofdCode": 13
}
]
'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Розничных продаж.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/fb5cbcba-0c4e-11e6-9464-e4de00000000",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "fb5cbcba-0c4e-11e6-9464-e4de00000000",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 11:06:44",
"name": "666dem",
"externalCode": "zyOXI-sjg98Ns7iwAA2Pe2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-27 11:06:44",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 0,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/fb5cbcba-0c4e-11e6-9464-e4de00000000/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscal": false,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 0,
"noCashSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/d6dd9a8a-0c5a-11e6-9464-e4de00000016",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "d6dd9a8a-0c5a-11e6-9464-e4de00000016",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 12:49:57",
"name": "100500_200_300",
"code": "fuuuuCodfe1",
"externalCode": "sd1wqsfa2qas",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-30 13:06:42",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 17722,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/d6dd9a8a-0c5a-11e6-9464-e4de00000016/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscalPrinterInfo": "The freaking worst FiscalPrinter ever!!",
"documentNumber": 3,
"checkNumber": 1221,
"checkSum": 1,
"fiscal": false,
"sessionNumber": 13,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 17722,
"noCashSum": 0
}
]
Удалить Розничную продажу
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной продажи. |
Запрос на удаление Розничной продажи с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Розничной продажи.
Метаданные Розничных продаж
Метаданные Розничных продаж
Запрос на получение метаданных Розничных продаж. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Розничных продаж + attributes - Массив объектов доп. полей Розничных продаж в формате Метаданных + states - Массив статусов Розничных продаж + createShared - создавать новые Розничные продажи с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Розничных продаж
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Розничных продаж.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "retaildemand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "retaildemand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata/states/fb56cf4f-2e58-11e6-8a84-bae50000006b",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cf4f-2e58-11e6-8a84-bae50000006b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Собран",
"color": 8767198,
"stateType": "Regular",
"entityType": "retaildemand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata/states/fb56d433-2e58-11e6-8a84-bae50000006c",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d433-2e58-11e6-8a84-bae50000006c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отгружен",
"color": 10774205,
"stateType": "Regular",
"entityType": "retaildemand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata/states/fb56d92f-2e58-11e6-8a84-bae50000006d",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d92f-2e58-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Доставлен",
"color": 8825440,
"stateType": "Successful",
"entityType": "retaildemand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata/states/fb56de0a-2e58-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56de0a-2e58-11e6-8a84-bae50000006e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Возврат",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "retaildemand"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata/states/fb56e2b4-2e58-11e6-8a84-bae50000006f",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56e2b4-2e58-11e6-8a84-bae50000006f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отменен",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "retaildemand"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata/attributes/f04d010f-558c-11e6-8a84-bae50000009d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "f04d010f-558c-11e6-8a84-bae50000009d",
"name": "Инфо о клиенте",
"type": "text",
"required": true
}
Шаблон розничной продажи
Шаблон розничной продажи
Запрос на получение предзаполненого стандартными значениями шаблона розничной продажи на основе других документов. При получении шаблона розничной продажи, всегда обязательно указывать ссылку на розничную смену. Без связи со сменой, получить шаблон продажи нельзя. Шаблон продажи можно получить на основе: + Розничной смены + Заказа покупателя
Пример получения шаблона розничной продажи с телом запроса, содержащим информацию о розничной смене.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"name": "666dem"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной розничной продажи.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/d7a0c095-d7d9-11e6-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/d732fca4-d7d9-11e6-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2017-03-16 16:09:44",
"applicable": true,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/d7db331a-d7d9-11e6-1542-821d00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/d7cac318-d7d9-11e6-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
}
},
"documents": {
"rows": []
},
"positions": {
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"fiscal": false,
"cashSum": 0,
"noCashSum": 0
}
Пример получения шаблона розничной продажи с телом запроса, содержащим информацию о розничной смене и заказе покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/1b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "customerorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной розничной продажи.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/d7a0c095-d7d9-11e6-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/d732fca4-d7d9-11e6-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2017-03-16 16:09:44",
"applicable": true,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/d7db331a-d7d9-11e6-1542-821d00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/d7cac318-d7d9-11e6-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
}
},
"positions": [
{
"quantity": 1,
"price": 1000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "http://localhost:8081/api/remap/1.2/entity/product/9f9ac08a-e0e3-11e7-9464-e4de00000003",
"metadataHref": "http://localhost:8081/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "http://localhost:8081/app/#good/edit?id=9f97f569-e0e3-11e7-9464-e4de00000001"
}
}
}
],
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0,
"fiscal": false,
"cashSum": 0,
"noCashSum": 0,
"customerOrder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/customerorder/1b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "customerorder",
"mediaType": "application/json"
}
}
}
Розничная продажа
Получить Розничную продажу
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной продажи. |
Запрос на получение отдельной Розничной продажи с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Розничной продажи с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/cdccba00-0563-11e6-9464-e4de00000090",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "cdccba00-0563-11e6-9464-e4de00000090",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-18 15:48:09",
"name": "00002",
"externalCode": "ctnglspQg2UGQ388P4pzY3",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"syncId": "d8996a1c-e7ea-470a-994f-a82fdf3190e5",
"moment": "2016-04-18 15:48:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 1800,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/cdccba00-0563-11e6-9464-e4de00000090/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscal": false,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/cd86df19-0563-11e6-9464-e4de0000008e",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 0,
"noCashSum": 1800
}
Изменить Розничную продажу
Запрос на обновление Розничной продажи с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Розничной продажи, кроме тех, что
помечены Только для чтения в описании атрибутов Розничной продажи.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Также, если вы изменяете поля cashSum и noCashSum их сумма должна совпадать с суммой по Розничной продаже (т.е. с суммарной стоимостью всех позиций).
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной продажи. |
Пример запроса на обновление Розничной продажи.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"name": "100500_200_300",
"moment": "2016-04-30 13:06:42",
"applicable": false,
"sum": 32402222220,
"payedSum": 23622200,
"fiscal": false,
"fiscalPrinterInfo": "The freaking worst FiscalPrinter ever!!",
"documentNumber": 3,
"checkNumber": 1221,
"checkSum": 1,
"sessionNumber": 251251,
"ofdCode": 13
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Розничной продажи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/d6dd9a8a-0c5a-11e6-9464-e4de00000016",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "d6dd9a8a-0c5a-11e6-9464-e4de00000016",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 12:49:57",
"name": "100500_200_300",
"code": "fuuuuCodfe1",
"externalCode": "sd1wqsfa2qas",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-30 13:06:42",
"applicable": false,
"vatEnabled": true,
"vatIncluded": true,
"sum": 17722,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/d6dd9a8a-0c5a-11e6-9464-e4de00000016/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscalPrinterInfo": "The freaking worst FiscalPrinter ever!!",
"documentNumber": 3,
"checkNumber": 1221,
"checkSum": 1,
"fiscal": false,
"sessionNumber": 13,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 17722,
"noCashSum": 0
}
Пример запроса на обновление Розничной продажи с доп. полями и позициями в теле запроса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"type": "retailshift",
"mediaType": "application/json"
}
},
"name": "100500",
"moment": "2016-04-27 13:06:42",
"applicable": true,
"sum": 32400,
"payedSum": 23622200,
"fiscal": true,
"fiscalPrinterInfo": "The freaking best FiscalPrinter ever!!",
"documentNumber": 329,
"checkNumber": 124421,
"checkSum": 200,
"sessionNumber": 251251,
"ofdCode": 13,
"positions": [
{
"quantity": 10,
"price": 1330,
"discount": 0,
"vat": 1,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 22,
"price": 201,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Розничной продажи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/d6dd9a8a-0c5a-11e6-9464-e4de00000016",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
},
"id": "d6dd9a8a-0c5a-11e6-9464-e4de00000016",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 12:47:21",
"name": "100500",
"code": "fuuuuCodfe1",
"externalCode": "sd1wqsfa2qas",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-27 13:06:42",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 17722,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "bb08dccf-0bd2-11e6-9464-e4de000000ae",
"name": "ыаыфацфыа",
"type": "string",
"value": "Веселый атрибут"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/d6dd9a8a-0c5a-11e6-9464-e4de00000016/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"payedSum": 0,
"fiscalPrinterInfo": "The freaking best FiscalPrinter ever!!",
"documentNumber": 329,
"checkNumber": 124421,
"checkSum": 200,
"fiscal": true,
"sessionNumber": 13,
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/0b2b2caf-055e-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 17722,
"noCashSum": 0
}
Позиции Розничной продажи
Отдельный ресурс для управления позициями Розничной продажи. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить Позиции
Запрос на получение списка всех позиций данной Розничной продажи. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Розничной продажи.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной продажи. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Позиции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций Розничной продажи.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e/positions",
"type": "demandposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e/positions/0b7ab774-055e-11e6-9464-e4de0000007f",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "0b7ab774-055e-11e6-9464-e4de0000007f",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 17,
"price": 300,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/60fc3826-00d7-11e6-9464-e4de00000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
},
"cost": 100
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e/positions/0b7acad5-055e-11e6-9464-e4de00000080",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "0b7acad5-055e-11e6-9464-e4de00000080",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/e91042b4-fa34-11e5-9464-e4de00000095",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"things": [
"1013431",
"31d22211sa"
]
}
}
]
}
Создать Позицию
Запрос на создание новой позиции в Розничной продаже. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Розничной продажи. + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Розничной продажи. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной продажи. |
Пример запроса на создание позиций в Розничной продаже.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 103,
"price": 999,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
},
"things": [
"1013431",
"31d22211sa"
]
},
{
"quantity": 21,
"price": 100,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 3,
"price": 35300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "service",
"mediaType": "application/json"
}
},
"cost": 130
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданных позиций.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e/positions/36a91302-0c60-11e6-9464-e4de00000029",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "36a91302-0c60-11e6-9464-e4de00000029",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 103,
"price": 999,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"things": [
"1013431",
"31d22211sa"
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e/positions/36a91e63-0c60-11e6-9464-e4de0000002a",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "36a91e63-0c60-11e6-9464-e4de0000002a",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 21,
"price": 100,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e/positions/36a92838-0c60-11e6-9464-e4de0000002b",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "36a92838-0c60-11e6-9464-e4de0000002b",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 3,
"price": 35300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/c02e3a5c-007e-11e6-9464-e4de00000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
},
"cost": 130
}
]
Позиция Розничной продажи
Получить Позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной продажи. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Розничной продажи. |
Запрос на получение отдельной позиции Розничной продажи с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Розничной продажи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e/positions/0b7ab774-055e-11e6-9464-e4de0000007f",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "0b7ab774-055e-11e6-9464-e4de0000007f",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 17,
"price": 300,
"discount": 0,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/60fc3826-00d7-11e6-9464-e4de00000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
},
"cost": 100
}
Изменить Позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной продажи. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Розничной продажи. |
Запрос на обновление отдельной позиции Розничной продажи.
Пример запроса на обновление отдельной позиции в Розничной продаже.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 90,
"price": 26700,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Розничной продажи.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/0b71daec-055e-11e6-9464-e4de0000007e/positions/0b7ab774-055e-11e6-9464-e4de0000007f",
"type": "demandposition",
"mediaType": "application/json"
},
"id": "0b7ab774-055e-11e6-9464-e4de0000007f",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 90,
"price": 26700,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничной продажи. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Розничной продажи. |
Запрос на удаление отдельной позиции Розничной продажи с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Розничной продажи.
Документ Розничный возврат
Средствами JSON API можно создавать и обновлять сведения о Розничных возвратах, запрашивать списки Розничных возвратов и сведения по отдельным Розничным возвратам. Позициями Розничных возвратов можно управлять как в составе отдельного Возврата, так и отдельно - с помощью специальных ресурсов для управления позициями Розничного возврата. Кодом сущности для Розничного возврата в составе JSON API является ключевое слово retailsalesreturn.
Розничные возвраты
Атрибуты сущности
- meta - Метаданные о Розничном возврате
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Розничного возврата
- description - Комментарий Розничного возврата
- externalCode - Внешний код Розничного возврата
- moment - Дата Розничного возврата
- applicable - Отметка о проведении
- vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- sum - Сумма Розничного возврата в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- project - Ссылка на проект в формате Метаданных
- state - Статус Розничного возврата в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения - positions - Ссылка на позиции Розничного возврата в формате Метаданных
- demand - Ссылка на Розничную продажу, по которой произошёл возврат в формате Метаданных. Поле является необходимым для возврата на основании.
- retailStore - Ссылка на точку продаж в формате Метаданных
Необходимое - retailShift - Ссылка на Розничную смену, в рамках которой была проведена продажа в формате Метаданных
Необходимое - cashSum - Оплачено наличными. Поле является необходимым для возврата без основания
- noCashSum - Оплачено картой. Поле является необходимым для возврата без основания
Позиции Розничного возврата
Позиции Розничного возврата - это список товаров/услуг/модификаций/серий.
Объект позиции Розничного возврата содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ discount - Процент скидки или наценки. Должен совпадать с указанным в продаже (игнорируется для возврата без основания)
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ cost - Себестоимость за единицу в копейках. Можно задать только для розничных возвратов без основания.
+ things - Серийные номера
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
С позициями можно работать с помощью специальных ресурсов для управления позициями Розничного возврата, а также в составе отдельного Розничного возврата. При работе в составе отдельного Розничного возврата, вы можете отправлять запросы на создание отдельного Розничного возврата с включенным в тело запроса массивом позиций Розничного возврата. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Розничного возврата". Также, при работе в составе отдельного Розничного возврата, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Розничного возврата. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Розничного возврата" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Розничных возвратов можно прочитать здесь
Получить Розничные возвраты
Запрос всех Розничных возвратов на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Розничные возвраты.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Розничные возвраты
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Розничных возвратов.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailSalesReturn",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailSalesReturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/a62e39af-0c75-11e6-9464-e4de00000030",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"id": "a62e39af-0c75-11e6-9464-e4de00000030",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 15:43:31",
"name": "00001",
"externalCode": "33YOoIGVhdPXFBr8QNbD50",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"syncId": "eefa141e-0c65-4993-8b16-934905d47dbd",
"moment": "2016-04-27 15:43:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 14000,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/a62e39af-0c75-11e6-9464-e4de00000030/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/2ef43ba7-0c5a-11e6-9464-e4de0000000c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/9e46db1e-0c75-11e6-9464-e4de0000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
]
}
Создать Розничный возврат
Розничная смена, на которую указывает ссылка при создании Розничного возврата обязательно должна быть активной. При создании Розничного возврата через JSON API, дата, указанная в moment возврата должна быть позже даты, указанной в moment активной розничной смены, иначе произойдёт ошибка. Обязательные поля при создании нового Розничного возврата: + name - Номер возврата + organization - Ссылка на ваше юрлицо в формате Метаданных + store - Ссылка на склад в формате Метаданных + demand - Ссылка на Розничную продажу, по которой произошёл возврат в формате Метаданных, обязательное поле только для возврата на основании + retailStore - Ссылка на точку продаж в формате Метаданных + retailShift - Сссылка на Розничную смену, в рамках которой происходит возврат + agent - Ссылка на контрагента в формате Метаданных. Контрагент, указанный в запросе на создание возврата, должен совпадать с контрагентом, указанном в документе, по которому создаётся возврат. + cashSum - Оплачено наличными. Поле является необходимым для возврата без основания + noCashSum - Оплачено картой. Поле является необходимым для возврата без основания
При создании возврата: + Контрагент в возврате и в документе, по которому он создаётся, должны совпадать + Валюта и юрлицо в возврате и в документе так же должны совпадать + При передаче коллекции positions в теле запроса на создание возврата, передаваемые позиции должны соответствовать позициям в документе. Различие может быть только в количестве товара в позиции (меньшее либо равное количеству в документе). Нельзя передать позиции, которых нет в документе.
Пример создания новой Розничного возврата с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "123142vzvrt",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/107430bc-36e7-11e7-8a7f-40d000000090",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/1076a96a-36e7-11e7-8a7f-40d000000092",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/10a79ac5-36e7-11e7-8a7f-40d00000009f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/700f8635-36f7-11e7-8a7f-40d00000011e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/6fe7b0da-36f7-11e7-8a7f-40d00000011c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Розничного возврата.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/80a2ea3b-3713-11e7-8a7f-40d000000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"id": "80a2ea3b-3713-11e7-8a7f-40d000000003",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/105a788e-36e7-11e7-8a7f-40d000000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/103cca6f-36e7-11e7-8a7f-40d000000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-05-12 16:04:15",
"name": "123142vzvrt",
"externalCode": "1-hpzSjAjCxS2dj55ZFeG2",
"moment": "2017-05-12 16:04:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/1076a96a-36e7-11e7-8a7f-40d000000092",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/109e931d-36e7-11e7-8a7f-40d00000009d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/107430bc-36e7-11e7-8a7f-40d000000090",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-05-12 16:04:15",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/80a2ea3b-3713-11e7-8a7f-40d000000003/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/700f8635-36f7-11e7-8a7f-40d00000011e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/10a79ac5-36e7-11e7-8a7f-40d00000009f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/6fe7b0da-36f7-11e7-8a7f-40d00000011c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 0,
"noCashSum": 0
}
Пример создания нового Розничного возврата с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "123142vzvrt",
"description": "Розничный возврат по просьбе покупателя",
"code": "303",
"externalCode": "2250005aas-cszsz",
"moment": "2016-05-06 14:47:47",
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/ee37a4b0-137a-11e6-9464-e4de000000e4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/5fa6624c-1380-11e6-9464-e4de00000205",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/5f67a979-1380-11e6-9464-e4de00000203",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "c72ffba9-1380-11e6-9464-e4de00000232",
"value": false
},
{
"id": "c72ff31e-1380-11e6-9464-e4de00000231",
"value": "3325-4214-42145-4211"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Розничного возврата.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/5d6c0d07-1381-11e6-9464-e4de00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"id": "5d6c0d07-1381-11e6-9464-e4de00000000",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"updated": "2016-05-06 14:55:01",
"name": "123142vzvrt",
"description": "Розничный возврат по просьбе покупателя",
"code": "303",
"externalCode": "2250005aas-cszsz",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-05-06 14:47:47",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/ee37a4b0-137a-11e6-9464-e4de000000e4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/31ace095-137a-11e6-9464-e4de0000005b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ff31e-1380-11e6-9464-e4de00000231",
"name": "Номер карты",
"type": "string",
"value": "3325-4214-42145-4211"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ffba9-1380-11e6-9464-e4de00000232",
"name": "Возврат на карту",
"type": "boolean",
"value": false
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/5d6c0d07-1381-11e6-9464-e4de00000000/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/5fa6624c-1380-11e6-9464-e4de00000205",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/5f67a979-1380-11e6-9464-e4de00000203",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 0,
"noCashSum": 0
}
Пример запроса на создание Розничного возврата с позициями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "123142vzvrt",
"description": "Розничный возврат по просьбе покупателя",
"code": "303",
"externalCode": "2250005aas-cszsz",
"moment": "2016-05-06 14:47:47",
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/ee37a4b0-137a-11e6-9464-e4de000000e4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/5fa6624c-1380-11e6-9464-e4de00000205",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/5f67a979-1380-11e6-9464-e4de00000203",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "c72ffba9-1380-11e6-9464-e4de00000232",
"value": false
},
{
"id": "c72ff31e-1380-11e6-9464-e4de00000231",
"value": "3325-4214-42145-4211"
}
],
"positions": [
{
"quantity": 5,
"price": 30000,
"discount": 0,
"vat": 20,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/0805a582-137b-11e6-9464-e4de0000010c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"quantity": 7,
"price": 30000,
"discount": 0,
"vat": 20,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/07fe4cad-137b-11e6-9464-e4de000000fd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Розничного возврата.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"id": "c1ab79f5-1381-11e6-9464-e4de00000005",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"updated": "2016-05-06 14:57:50",
"name": "123142vzvrt",
"description": "Розничный возврат по просьбе покупателя",
"code": "303",
"externalCode": "2250005aas-cszsz",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-05-06 14:47:47",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/ee37a4b0-137a-11e6-9464-e4de000000e4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"sum": 360000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/31ace095-137a-11e6-9464-e4de0000005b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ff31e-1380-11e6-9464-e4de00000231",
"name": "Номер карты",
"type": "string",
"value": "3325-4214-42145-4211"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ffba9-1380-11e6-9464-e4de00000232",
"name": "Возврат на карту",
"type": "boolean",
"value": false
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/5fa6624c-1380-11e6-9464-e4de00000205",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/5f67a979-1380-11e6-9464-e4de00000203",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 360000,
"noCashSum": 0
}
Пример запроса на создание Розничного возврата без основания.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "123142vzvrt",
"description": "Розничный возврат по просьбе покупателя",
"code": "303",
"externalCode": "2250005aas-cszsz",
"moment": "2016-05-06 14:47:47",
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/ee37a4b0-137a-11e6-9464-e4de000000e4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/5f67a979-1380-11e6-9464-e4de00000203",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "c72ffba9-1380-11e6-9464-e4de00000232",
"value": false
},
{
"id": "c72ff31e-1380-11e6-9464-e4de00000231",
"value": "3325-4214-42145-4211"
}
],
"positions": [
{
"quantity": 5,
"price": 30000,
"discount": 0,
"vat": 20,
"cost": 2500,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/0805a582-137b-11e6-9464-e4de0000010c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"quantity": 7,
"price": 30000,
"discount": 0,
"vat": 20,
"cost": 3000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/07fe4cad-137b-11e6-9464-e4de000000fd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
}
],
"cashSum": 300000,
"noCashSum": 60000
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Розничного возврата.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"id": "c1ab79f5-1381-11e6-9464-e4de00000005",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"updated": "2016-05-06 14:57:50",
"name": "123142vzvrt",
"description": "Розничный возврат по просьбе покупателя",
"code": "303",
"externalCode": "2250005aas-cszsz",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-05-06 14:47:47",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/ee37a4b0-137a-11e6-9464-e4de000000e4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"sum": 360000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/31ace095-137a-11e6-9464-e4de0000005b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ff31e-1380-11e6-9464-e4de00000231",
"name": "Номер карты",
"type": "string",
"value": "3325-4214-42145-4211"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ffba9-1380-11e6-9464-e4de00000232",
"name": "Возврат на карту",
"type": "boolean",
"value": false
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 2,
"limit": 100,
"offset": 0
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/5f67a979-1380-11e6-9464-e4de00000203",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"cashSum": 300000,
"noCashSum": 60000
}
Массовое создание и обновление Розничных возвратов
Массовое создание и обновление Розничных возвратов. В теле запроса нужно передать массив, содержащий JSON представления Розничных возвратов, которые вы хотите создать или обновить. Обновляемые Розничные возвраты должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Розничных возвратов
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "123142vzvrt",
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/107430bc-36e7-11e7-8a7f-40d000000090",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/1076a96a-36e7-11e7-8a7f-40d000000092",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/10a79ac5-36e7-11e7-8a7f-40d00000009f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/700f8635-36f7-11e7-8a7f-40d00000011e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/6fe7b0da-36f7-11e7-8a7f-40d00000011c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"vatEnabled": false,
"vatIncluded": false,
"name": "newName",
"code": "3033",
"positions": [
{
"quantity": 6,
"price": 30000,
"discount": 0,
"vat": 20,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/07f8fb39-137b-11e6-9464-e4de000000f3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 250
},
{
"quantity": 2,
"price": 20000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/27a803bd-137b-11e6-9464-e4de0000013a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 370
},
{
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 4,
"price": 40000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609e36c0-137b-11e6-9464-e4de00000179",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 490
},
{
"quantity": 4,
"price": 40000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609c2418-137b-11e6-9464-e4de00000174",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 510
}
]
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Розничных возвратов.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/80a2ea3b-3713-11e7-8a7f-40d000000003",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"id": "80a2ea3b-3713-11e7-8a7f-40d000000003",
"accountId": "103bff1b-36e7-11e7-8a7f-40d000000004",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/105a788e-36e7-11e7-8a7f-40d000000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/103cca6f-36e7-11e7-8a7f-40d000000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-05-12 16:04:15",
"name": "123142vzvrt",
"externalCode": "1-hpzSjAjCxS2dj55ZFeG2",
"moment": "2017-05-12 16:04:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/10772c12-36e7-11e7-8a7f-40d000000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/1076a96a-36e7-11e7-8a7f-40d000000092",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/109e931d-36e7-11e7-8a7f-40d00000009d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/107430bc-36e7-11e7-8a7f-40d000000090",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-05-12 16:04:15",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/80a2ea3b-3713-11e7-8a7f-40d000000003/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/700f8635-36f7-11e7-8a7f-40d00000011e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/10a79ac5-36e7-11e7-8a7f-40d00000009f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/6fe7b0da-36f7-11e7-8a7f-40d00000011c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"id": "c1ab79f5-1381-11e6-9464-e4de00000005",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"updated": "2016-05-06 15:02:27",
"name": "newName",
"description": "Розничный возврат по просьбе покупателя",
"code": "3033",
"externalCode": "2250005aas-cszsz",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-05-06 14:47:47",
"applicable": true,
"vatEnabled": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/ee37a4b0-137a-11e6-9464-e4de000000e4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"sum": 540000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/31ace095-137a-11e6-9464-e4de0000005b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ff31e-1380-11e6-9464-e4de00000231",
"name": "Номер карты",
"type": "string",
"value": "3325-4214-42145-4211"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ffba9-1380-11e6-9464-e4de00000232",
"name": "Возврат на карту",
"type": "boolean",
"value": false
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/5fa6624c-1380-11e6-9464-e4de00000205",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/5f67a979-1380-11e6-9464-e4de00000203",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
]
Удалить Розничный возврат
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничного возврата. |
Запрос на удаление Розничного возврата с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Розничного возврата.
Метаданные Розничных возвратов
Метаданные Розничных возвратов
Запрос на получение метаданных Розничных возвратов. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Розничных возвратов + attributes - Массив объектов доп. полей Розничных возвратов в формате Метаданных + states - Массив статусов Розничных возвратов + createShared - создавать новые Розничные возвраты с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Розничных возвратов
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Розничных возвратов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "c72ff31e-1380-11e6-9464-e4de00000231",
"name": "Номер карты",
"type": "string",
"required": false
},
{
"id": "c72ffba9-1380-11e6-9464-e4de00000232",
"name": "Возврат на карту",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "retailsalesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "retailsalesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata/states/fb56cf4f-2e58-11e6-8a84-bae50000006b",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cf4f-2e58-11e6-8a84-bae50000006b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Собран",
"color": 8767198,
"stateType": "Regular",
"entityType": "retailsalesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata/states/fb56d433-2e58-11e6-8a84-bae50000006c",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d433-2e58-11e6-8a84-bae50000006c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отгружен",
"color": 10774205,
"stateType": "Regular",
"entityType": "retailsalesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata/states/fb56d92f-2e58-11e6-8a84-bae50000006d",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d92f-2e58-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Доставлен",
"color": 8825440,
"stateType": "Successful",
"entityType": "retailsalesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata/states/fb56de0a-2e58-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56de0a-2e58-11e6-8a84-bae50000006e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Возврат",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "retailsalesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata/states/fb56e2b4-2e58-11e6-8a84-bae50000006f",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56e2b4-2e58-11e6-8a84-bae50000006f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отменен",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "retailsalesreturn"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata/attributes/9b0c8d28-558c-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "9b0c8d28-558c-11e6-8a84-bae50000008a",
"name": "Дата возвращённого документа",
"type": "time",
"required": false
}
Шаблон розничного возврата
Шаблон розничного возврата на основе
Запрос на получение предзаполненого стандартными значениями шаблона розничного возврата на основе других документов. Шаблон розничного возврата можно получить на основе: + Розничной смены + Розничной продажи
При запросе шаблона только с розничной сменой в результате получиться шаблон возврата без основания. При запросе шаблона с указанием розничной продажи, розничная смена может быть заполнена из неё.
Пример запроса на создание шаблона розничного возврата на основе смены.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/ed8de012-479b-11e8-7ae5-8ba2000000ce",
"type": "retailshift",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного розничного возврата.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/e346e355-2780-11e8-0532-9eed0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=e346e355-2780-11e8-0532-9eed0000002a"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/e29e01d3-2780-11e8-0532-9eed00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "",
"moment": "2018-05-08 13:00:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/e37f9321-2780-11e8-0532-9eed00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=e37f9321-2780-11e8-0532-9eed00000058"
}
}
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e37edd82-2780-11e8-0532-9eed00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=e37edd82-2780-11e8-0532-9eed00000053"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/030a5127-3663-11e8-56c0-000800000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=030a5127-3663-11e8-56c0-000800000000"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/e37a6d1c-2780-11e8-0532-9eed00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=e37a6d1c-2780-11e8-0532-9eed00000051"
}
},
"documents": {
"rows": []
},
"positions": {
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/ed8de012-479b-11e8-7ae5-8ba2000000ce",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#retailshift/edit?id=ed8de012-479b-11e8-7ae5-8ba2000000ce"
}
}
}
Пример запроса на создание шаблона розничного возврата на основе розничной продажи.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/e806748e-9639-41da-8f2e-5e197312eac2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного розничного возврата.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/e346e355-2780-11e8-0532-9eed0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=e346e355-2780-11e8-0532-9eed0000002a"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/e29e01d3-2780-11e8-0532-9eed00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "",
"moment": "2018-05-08 13:00:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/e37f9321-2780-11e8-0532-9eed00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=e37f9321-2780-11e8-0532-9eed00000058"
}
}
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/e37edd82-2780-11e8-0532-9eed00000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#warehouse/edit?id=e37edd82-2780-11e8-0532-9eed00000053"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/030a5127-3663-11e8-56c0-000800000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=030a5127-3663-11e8-56c0-000800000000"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/e37a6d1c-2780-11e8-0532-9eed00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=e37a6d1c-2780-11e8-0532-9eed00000051"
}
},
"documents": {
"rows": []
},
"positions": {
"rows": [
{
"quantity": 1,
"price": 16000,
"discount": 10,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/03216395-3663-11e8-56c0-000800000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=03201fa1-3663-11e8-56c0-000800000002"
}
}
}
]
},
"vatEnabled": true,
"vatIncluded": true,
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/e806748e-9639-41da-8f2e-5e197312eac2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#retaildemand/edit?id=e806748e-9639-41da-8f2e-5e197312eac2"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/ed8de012-479b-11e8-7ae5-8ba2000000ce",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#retailshift/edit?id=ed8de012-479b-11e8-7ae5-8ba2000000ce"
}
}
}
Розничный возврат
Получить Розничный возврат
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничного возврата. |
Запрос на получение отдельного Розничного возврата с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Розничного возврата с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/a62e39af-0c75-11e6-9464-e4de00000030",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"id": "a62e39af-0c75-11e6-9464-e4de00000030",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"updated": "2016-04-27 15:43:31",
"name": "00001",
"externalCode": "33YOoIGVhdPXFBr8QNbD50",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"syncId": "eefa141e-0c65-4993-8b16-934905d47dbd",
"moment": "2016-04-27 15:43:00",
"applicable": true,
"vatEnabled": true,
"vatIncluded": true,
"sum": 14000,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/8518d001-f504-11e5-8a84-bae50000016a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/a62e39af-0c75-11e6-9464-e4de00000030/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/851f8576-f504-11e5-8a84-bae50000016c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/2ef43ba7-0c5a-11e6-9464-e4de0000000c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/9e46db1e-0c75-11e6-9464-e4de0000002b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
Изменить Розничный возврат
Запрос на обновление Розничного возврата с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Розничного возврата, кроме тех, что
помечены Только для чтения в описании атрибутов Розничного возврата.
При обновлении поля organization нужно также обновить поле organizationAccount иначе произойдёт ошибка.
Контрагент должен совпадать с контрагентом, указанным в документе, по которому создаётся возврат.
При обновлении возврата: + Нельзя изменять следующие поля: agentAccount, agent, demand + Нельзя выставить валюту отличную от валюты в документе + Нельзя добавить позиции, отсутствующие среди позиций документа.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничного возврата. |
Пример запроса на обновление Розничного возврата.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"vatEnabled": false,
"vatIncluded": false,
"name": "newName",
"code": "3033",
"positions": [
{
"quantity": 6,
"price": 30000,
"discount": 0,
"vat": 20,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/07f8fb39-137b-11e6-9464-e4de000000f3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 250
},
{
"quantity": 2,
"price": 20000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/27a803bd-137b-11e6-9464-e4de0000013a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 370
},
{
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 4,
"price": 40000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609e36c0-137b-11e6-9464-e4de00000179",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 490
},
{
"quantity": 4,
"price": 40000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609c2418-137b-11e6-9464-e4de00000174",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 510
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Розничного возврата.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/metadata",
"type": "retailsalesreturn",
"mediaType": "application/json"
},
"id": "c1ab79f5-1381-11e6-9464-e4de00000005",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"updated": "2016-05-06 15:02:27",
"name": "newName",
"description": "Розничный возврат по просьбе покупателя",
"code": "3033",
"externalCode": "2250005aas-cszsz",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-05-06 14:47:47",
"applicable": true,
"vatEnabled": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/ee37a4b0-137a-11e6-9464-e4de000000e4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 71
},
"sum": 540000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/30f01af0-137a-11e6-9464-e4de0000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/30fe30a0-137a-11e6-9464-e4de00000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/31ace095-137a-11e6-9464-e4de0000005b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ff31e-1380-11e6-9464-e4de00000231",
"name": "Номер карты",
"type": "string",
"value": "3325-4214-42145-4211"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata/attributes/0cd74e1e-2e59-11e6-8a84-bae50000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "c72ffba9-1380-11e6-9464-e4de00000232",
"name": "Возврат на карту",
"type": "boolean",
"value": false
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"retailStore": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/31b6349e-137a-11e6-9464-e4de0000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailstore/metadata",
"type": "retailstore",
"mediaType": "application/json"
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/5fa6624c-1380-11e6-9464-e4de00000205",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildemand/metadata",
"type": "retaildemand",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/5f67a979-1380-11e6-9464-e4de00000203",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
Позиции Розничного возврата
Отдельный ресурс для управления позициями Розничного возврата. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить Позиции
Запрос на получение списка всех позиций данной Розничного возврата. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Розничного возврата.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничного возврата. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Позиции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций Розничного возврата.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions/6702da17-1382-11e6-9464-e4de0000000e",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "6702da17-1382-11e6-9464-e4de0000000e",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 6,
"price": 30000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/07f8fb39-137b-11e6-9464-e4de000000f3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 25
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions/6702ecc7-1382-11e6-9464-e4de0000000f",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "6702ecc7-1382-11e6-9464-e4de0000000f",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 2,
"price": 20000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/27a803bd-137b-11e6-9464-e4de0000013a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 37
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions/6703f8ae-1382-11e6-9464-e4de00000010",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "6703f8ae-1382-11e6-9464-e4de00000010",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 4,
"price": 40000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609e36c0-137b-11e6-9464-e4de00000179",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 49
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions/67040794-1382-11e6-9464-e4de00000011",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "67040794-1382-11e6-9464-e4de00000011",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 4,
"price": 40000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609c2418-137b-11e6-9464-e4de00000174",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 51
}
]
}
Создать Позицию
Запрос на создание новой позиции в Розничном возврате. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Розничного возврата. + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Розничного возврата. Все созданные данным запросом позиции будут добавлены к уже существующим. Нельзя создавать позиции, отличные от позиций в документе, по которому создаётся возврат. Допустимо только отличие в quantity позиций (количество в позиции в возврате м.б. меньше или равно количеству в позиции в документе).
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничного возврата. |
Пример запроса на создание позиций в Розничном возврате.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 103,
"price": 999,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609e36c0-137b-11e6-9464-e4de00000179",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 25
},
{
"quantity": 21,
"price": 100,
"discount": 0,
"vat": 21,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/07f8fb39-137b-11e6-9464-e4de000000f3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 37
},
{
"quantity": 3,
"price": 35300,
"discount": 0,
"vat": 7,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609e36c0-137b-11e6-9464-e4de00000179",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 49
}
]
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданных позиций.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions/13982b01-138a-11e6-9464-e4de00000018",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "13982b01-138a-11e6-9464-e4de00000018",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 103,
"price": 999,
"discount": 0,
"vat": 0,
"variant": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609e36c0-137b-11e6-9464-e4de00000179",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 25
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions/13998a65-138a-11e6-9464-e4de00000019",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "13998a65-138a-11e6-9464-e4de00000019",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 21,
"price": 100,
"discount": 0,
"vat": 0,
"variant": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/07f8fb39-137b-11e6-9464-e4de000000f3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 37
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions/13999856-138a-11e6-9464-e4de0000001a",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "13999856-138a-11e6-9464-e4de0000001a",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 3,
"price": 35300,
"discount": 0,
"vat": 0,
"variant": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609e36c0-137b-11e6-9464-e4de00000179",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 49
}
]
Позиция Розничного возврата
Получить Позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничного возврата. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Розничного возврата. |
Запрос на получение отдельной позиции Розничного возврата с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Розничного возврата.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions/13982b01-138a-11e6-9464-e4de00000018",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "13982b01-138a-11e6-9464-e4de00000018",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 103,
"price": 999,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609e36c0-137b-11e6-9464-e4de00000179",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 25
}
Изменить Позицию
Запрос на обновление отдельной позиции Розничного возврата. При обновлении отдельной позиции в возврате можно только изменить количество данной позиции. Причём это количество должно быть в пределах , где n - кол-во данной позиции в документе, по которому создан возврат.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничного возврата. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Розничного возврата. |
Пример запроса на обновление отдельной позиции в Розничном возврате.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 10,
"price": 3000,
"discount": 15,
"vat": 10,
"cost": 250
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Розничного возврата.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/c1ab79f5-1381-11e6-9464-e4de00000005/positions/13982b01-138a-11e6-9464-e4de00000018",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "13982b01-138a-11e6-9464-e4de00000018",
"accountId": "305f25aa-137a-11e6-9464-e4de00000001",
"quantity": 10,
"price": 3000,
"discount": 15,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/609e36c0-137b-11e6-9464-e4de00000179",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"cost": 250
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Розничного возврата. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Розничного возврата. |
Запрос на удаление отдельной позиции Розничного возврата с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/retailsalesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Розничного возврата.
Документ Внесение денег
Средствами JSON API можно создавать и обновлять сведения о внесениях денег, запрашивать списки внесений денег и сведения по отдельным внесениям денег. Кодом сущности для внесения денег в составе JSON API является ключевое слово retaildrawercashin. Больше о внесениях денег и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Внесения денег
Атрибуты сущности
- meta - Метаданные о внесении денег
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер внесения денег
- description - Комментарий внесения денег
- externalCode - Внешний код внесения денег
- moment - Дата внесения
- applicable - Отметка о проведении
- sum - Сумма внесения в установленной валюте
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на сотрудника, совершившего внесение, в формате Метаданных
Необходимое - state - Статус внесения в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения#### Связи с другими документами - retailShift - Ссылка на розничную смену, в рамках которой было выполнено внесение денег в формате Метаданных
Необходимое
Получить внесения денег
Запрос на получение всех внесений денег на данной учётной записи.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить внесения денег
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка внесений денег.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
},
"id": "179dd832-960c-11e6-8a84-bae5000000dc",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 17:55:36",
"name": "00001",
"description": "Внесение",
"externalCode": "2Rqfj4sNhkS98TU70DNRw1",
"moment": "2016-10-19 17:55:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 112312000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/2266b7e1-960c-11e6-8a84-bae5000000df",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
},
"id": "2266b7e1-960c-11e6-8a84-bae5000000df",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 17:55:54",
"name": "00002",
"description": "Коммент",
"externalCode": "Rk3nJ4y1hw3O3b9qJ6xN30",
"moment": "2016-10-19 17:55:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 2000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
]
}
Создать внесение денег
Запрос на создание внесения денег.
Пример создания нового внесения денег.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"sum": 100500,
"description": "Новое внесение через API"
}'
Response 200 Успешный запрос. Результат - массив JSON представлений созданного и обновленного внесения денег.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/b1bd1d12-960c-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
},
"id": "b1bd1d12-960c-11e6-8a84-bae500000009",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 17:59:54",
"name": "00003",
"description": "Новое внесение через API",
"externalCode": "fhlISdMTgl8C-lh9nLfIN0",
"moment": "2016-10-19 17:59:54",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 100500,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
Массовое создание и обновление внесений денег
Массовое создание и обновление внесений денег. В теле запроса нужно передать массив, содержащий JSON представления внесений денег, которые вы хотите создать или обновить. Обновляемые внесения денег должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких внесений денег
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"sum": 100500,
"description": "Новое внесение через API"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
},
"name": "0000004",
"sum": 700,
"applicable": false
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных внесений денег.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/b1bd1d12-960c-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
},
"id": "b1bd1d12-960c-11e6-8a84-bae500000009",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 17:59:54",
"name": "00003",
"description": "Новое внесение через API",
"externalCode": "fhlISdMTgl8C-lh9nLfIN0",
"moment": "2016-10-19 17:59:54",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 100500,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
},
"id": "179dd832-960c-11e6-8a84-bae5000000dc",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 18:03:00",
"name": "0000004",
"description": "Внесение",
"externalCode": "2Rqfj4sNhkS98TU70DNRw1",
"moment": "2016-10-19 17:55:00",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 700,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
]
Удалить внесение денег
Запрос на удаление внесения денег с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id внесения денег. |
Удалить внесение денег
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос.
Метаданные внесений денег
Метаданные внесений денег
Запрос на получение метаданных внесений денег. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные внесений денег + attributes - Массив объектов доп. полей внесений денег в формате Метаданных + states - Массив статусов внесений денег + createShared - создавать новые внесения денег с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные внесений денег
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей внесений денег.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "retaildrawercashin"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "retaildrawercashin"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
Шаблон внесения денег
Шаблон внесения денег
Запрос на получение предзаполненого стандартными значениями шаблона внесения денег без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного внесения денег.
{
"applicable": true,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}
Шаблон внесения денег на основе
Запрос на получение предзаполненного внесения денег на основе розничной смены.
В результате запроса, будет создан предзаполненный шаблон внесения денег на основе переданной
розничной смены.
Внимание! Не забывайте, что поле retailShift должно быть написано с большой S.
Запрос на создание внесения денег на основе розничной смены.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного внесения денег.
{
"applicable": true,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
Внесение денег
Получить внесение денег
Запрос на получение отдельного внесения денег с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление внесения денег с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
},
"id": "179dd832-960c-11e6-8a84-bae5000000dc",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 17:55:36",
"name": "00001",
"description": "Внесение",
"externalCode": "2Rqfj4sNhkS98TU70DNRw1",
"moment": "2016-10-19 17:55:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 112312000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
Изменить внесение денег
Запрос на обновление внесения денег.
Пример обновления внесения денег.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "0000004",
"sum": 700,
"applicable": false
}'
Response 200
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/179dd832-960c-11e6-8a84-bae5000000dc",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashin/metadata",
"type": "retaildrawercashin",
"mediaType": "application/json"
},
"id": "179dd832-960c-11e6-8a84-bae5000000dc",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 18:03:00",
"name": "0000004",
"description": "Внесение",
"externalCode": "2Rqfj4sNhkS98TU70DNRw1",
"moment": "2016-10-19 17:55:00",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 700,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
Документ Выплата денег
Средствами JSON API можно создавать и обновлять сведения о выплатах денег, запрашивать списки выплат денег и сведения по отдельным выплатам денег. Кодом сущности для внесения денег в составе JSON API является ключевое слово retaildrawercashout. Больше о выплатах денег и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке
Выплаты денег
Атрибуты сущности
- meta - Метаданные о выплате денег
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер выплаты денег
- description - Комментарий выплаты денег
- externalCode - Внешний код выплаты денег
- moment - Дата выплаты
- applicable - Отметка о проведении
- sum - Сумма выплата в установленной валюте
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на сотрудника, которому была совершена выплата, в формате Метаданных
Необходимое - state - Статус выплаты в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения
Связи с другими документами
- retailShift - Ссылка на розничную смену, в рамках которой была выполнена выплата денег в формате Метаданных
Необходимое
Получить выплаты денег
Запрос на получение всех выплат денег на данной учётной записи.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить выплаты денег
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка выплат денег.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/1c5afb86-9603-11e6-8a84-bae500000079",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json"
},
"id": "1c5afb86-9603-11e6-8a84-bae500000079",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 16:51:18",
"name": "00001",
"description": "Выплата",
"externalCode": "BYeqnCMUgjNIhODoqt5C52",
"syncId": "ece1344a-5a68-4d32-ac70-a56b943717b5",
"moment": "2016-10-19 16:51:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 12441200,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/1e24533f-9603-11e6-8a84-bae50000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json"
},
"id": "1e24533f-9603-11e6-8a84-bae50000007c",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 16:51:21",
"name": "00002",
"externalCode": "ohO0hmq7jioNXhM5xuTVe3",
"moment": "2016-10-19 16:51:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 111800200,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
]
}
Создать выплату денег
Запрос на создание выплаты денег.
Пример создания новой выплаты денег.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"sum": 100500,
"description": "Новая выплата через API"
}'
Response 200
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/c05a6fb8-960c-11e6-8a84-bae50000000c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json"
},
"id": "c05a6fb8-960c-11e6-8a84-bae50000000c",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 18:00:19",
"name": "00003",
"description": "Новое внесение через API",
"externalCode": "n19Ol5mFidHzBBojcTzvo3",
"moment": "2016-10-19 18:00:19",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 100500,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
Массовое создание и обновление выплат денег
Массовое создание и обновление выплат денег. В теле запроса нужно передать массив, содержащий JSON представления выплат денег, которые вы хотите создать или обновить. Обновляемые выплаты денег должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких выплат денег
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"sum": 100500,
"description": "Новая выплата через API"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/c05a6fb8-960c-11e6-8a84-bae50000000c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json"
},
"name": "0000004",
"sum": 700,
"applicable": false
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных выплат денег.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/c05a6fb8-960c-11e6-8a84-bae50000000c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json"
},
"id": "c05a6fb8-960c-11e6-8a84-bae50000000c",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 18:00:19",
"name": "00003",
"description": "Новое внесение через API",
"externalCode": "n19Ol5mFidHzBBojcTzvo3",
"moment": "2016-10-19 18:00:19",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 100500,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/c05a6fb8-960c-11e6-8a84-bae50000000c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json"
},
"id": "c05a6fb8-960c-11e6-8a84-bae50000000c",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 18:01:38",
"name": "0000004",
"description": "Новое внесение через API",
"externalCode": "n19Ol5mFidHzBBojcTzvo3",
"moment": "2016-10-19 18:00:19",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 700,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
]
Удалить внесение денег
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id выплаты денег. |
Запрос на удаление выплаты денег с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос.
Метаданные выплат денег
Метаданные выплат денег
Запрос на получение метаданных выплат денег. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные выплат денег + attributes - Массив объектов доп. полей выплат денег в формате Метаданных + states - Массив статусов выплат денег + createShared - создавать новые выплаты денег с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные выплат денег
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей выплат денег.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "retaildrawercashout"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "retaildrawercashout"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 5290a290-0313-11e6-9464-e4de00000020 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata/attributes/5290a290-0313-11e6-9464-e4de00000020",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "5290a290-0313-11e6-9464-e4de00000020",
"name": "attribute_name",
"type": "boolean",
"required": false
}
Шаблон выплаты денег
Шаблон выплаты денег
Запрос на получение предзаполненого стандартными значениями шаблона выплаты денег без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной выплаты денег.
{
"applicable": true,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}
Шаблон выплаты денег на основе
Запрос на получение предзаполненной выплаты денег на основе розничной смены. В результате запроса, будет создан предзаполненный шаблон выплаты денег на основе переданной розничной смены.
Запрос на создание выплаты денег на основе розничной смены.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной выплаты денег.
{
"applicable": true,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}
Выплата денег
Получить выплату денег
Запрос на получение отдельной выплаты денег с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление выплаты денег с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/1c5afb86-9603-11e6-8a84-bae500000079",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json"
},
"id": "1c5afb86-9603-11e6-8a84-bae500000079",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 16:51:18",
"name": "00001",
"description": "Выплата",
"externalCode": "BYeqnCMUgjNIhODoqt5C52",
"syncId": "ece1344a-5a68-4d32-ac70-a56b943717b5",
"moment": "2016-10-19 16:51:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 12441200,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
Изменить выплачу денег
Запрос на обновление выплаты денег.
Пример обновления выплаты денег.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "0000004",
"sum": 700,
"applicable": false
}'
Response 200
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/c05a6fb8-960c-11e6-8a84-bae50000000c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retaildrawercashout/metadata",
"type": "retaildrawercashout",
"mediaType": "application/json"
},
"id": "c05a6fb8-960c-11e6-8a84-bae50000000c",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-10-19 18:01:38",
"name": "0000004",
"description": "Новое внесение через API",
"externalCode": "n19Ol5mFidHzBBojcTzvo3",
"moment": "2016-10-19 18:00:19",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 700,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"retailShift": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/131aaeb6-9603-11e6-8a84-bae500000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/retailshift/metadata",
"type": "retailshift",
"mediaType": "application/json"
}
}
}
Документ Возврат покупателя
Средствами JSON API можно создавать и обновлять сведения о Возвратах покупателей, запрашивать списки Возвратов покупателей и сведения по отдельным Возвратам покупателей. Позициями Возвратов покупателей можно управлять как в составе отдельного Возврата, так и отдельно - с помощью специальных ресурсов для управления позициями Возврата покупателя. Кодом сущности для Возврата покупателя в составе JSON API является ключевое слово salesreturn.
Возвраты покупателей
Атрибуты сущности
- meta - Метаданные о Возврате покупателя
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Возврата покупателей
- description - Комментарий Возврата покупателей
- externalCode - Внешний код Возврата покупателей
- moment - Дата Возврата покупателей
- applicable - Отметка о проведении
- vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- sum - Сумма Возврата покупателей в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
- store - Ссылка на склад в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- project - Ссылка на проект в формате Метаданных
- state - Статус Возврата покупателей в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения - positions - Ссылка на позиции Возврата покупателей в формате Метаданных #### Связи с другими документами
- demand - Ссылка на отгрузку, по которой произошёл возврат в формате Метаданных Поле является необходимым для возврата с основанием.
- losses - Массив ссылок на связанные списания в формате Метаданных
- payments - Массив ссылок на связанные платежи в формате Метаданных
- payedSum - Сумма исходящих платежей по возврату покупателя
Позиции Возврата покупателя
Позиции Возврата покупателей - это список товаров/услуг/модификаций/серий.
Объект позиции Возврата покупателей содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках. Должна совпадать с указанной в продаже
+ discount - Процент скидки или наценки. Должен совпадать с указанным в отгрузке (игнорируется для возвратов без основания)
+ vat - НДС, которым облагается текущая позиция. Должен совпадать с указанным в продаже
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ cost - Себестоимость за единицу в копейках. Можно задать только для возвратов без основания.
+ things - Серийные номера
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
С позициями можно работать с помощью специальных ресурсов для управления позициями Возврата покупателей, а также в составе отдельного Возврата покупателей. При работе в составе отдельного Возврата покупателей, вы можете отправлять запросы на создание отдельного Возврата покупателей с включенным в тело запроса массивом позиций Возврата покупателей. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Возврата покупателей". Также, при работе в составе отдельного Возврата покупателей, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Возврата покупателей. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Возврата покупателей" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены. + gtd - ГТД + country - Ссылка на страну в формате Метаданных
О работе с доп. полями Возвратов покупателейых возвратов можно прочитать здесь
Получить Возвраты покупателей
Запрос всех Возвратов покупателей на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Возвраты покупателей.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Возвраты покупателей
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Возвратов покупателей.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"id": "90f337d1-3f80-11e6-8a84-bae5000000ac",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 14:40:10",
"name": "00001",
"externalCode": "PDJ7P5kVhEWomlQtd67up2",
"moment": "2016-07-01 14:39:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 25100,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf41a7b-2e58-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 6,
"limit": 1000,
"offset": 0
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/3ebb140e-2e62-11e6-8a84-bae500000127",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
},
"payedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"id": "9b83cb6b-3f80-11e6-8a84-bae5000000bb",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 14:40:27",
"name": "00002",
"externalCode": "3ZaZZNCVhYzDgTunfKsTy3",
"moment": "2016-07-01 14:40:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1100,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/9b83cb6b-3f80-11e6-8a84-bae5000000bb/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/d8937c31-3eb7-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
},
"payedSum": 0
}
]
}
Создать Возврат покупателя
Обязательные поля при создании нового Возврата покупателей: + name - Номер возврата + organization - Ссылка на ваше юрлицо в формате Метаданных + store - Ссылка на склад в формате Метаданных + demand - Ссылка на отгрузку, по которой произошёл возврат в формате Метаданных, обязательное поле только для возврата по основанию + agent - Ссылка на контрагента в формате Метаданных Контрагент, указанный в запросе на создание возврата, должен совпадать с контрагентом, указанном в документе, по которому создаётся возврат.
При создании возврата: + При создании возврата без основания поле demand указывать не нужно + Контрагент в возврате и в документе, по которому он создаётся, должны совпадать + Валюта и юрлицо в возврате и в документе так же должны совпадать + При передаче коллекции positions в теле запроса на создание возврата, передаваемые позиции должны соответствовать позициям в документе. Различие может быть только в количестве товара в позиции (меньшее либо равное количеству в документе). Нельзя передать позиции, которых нет в документе.
Пример создания нового Возврата покупателя.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "0003",
"description": "Гневный возврат бракованного товара",
"code": "k123e21451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": false,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "43dd9fd7-3f81-11e6-8a84-bae5000000db",
"value": "отломана деталь"
},
{
"id": "50463893-3f81-11e6-8a84-bae5000000de",
"value": true
}
],
"positions": [
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Возврата покупателя.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"id": "a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 15:16:37",
"name": "0003",
"description": "Гневный возврат бракованного товара",
"code": "k123e21451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "43dd9fd7-3f81-11e6-8a84-bae5000000db",
"name": "Причина возврата",
"type": "string",
"value": "отломана деталь"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "50463893-3f81-11e6-8a84-bae5000000de",
"name": "Брак",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
},
"payedSum": 0
}
Массовое создание и обновление Возвратов покупателя
Массовое создание и обновление Возвратов покупателя. В теле запроса нужно передать массив, содержащий JSON представления Возвратов покупателя, которые вы хотите создать или обновить. Обновляемые Возвраты покупателя должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Возвратов покупателя
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "0003",
"description": "Гневный возврат бракованного товара",
"code": "k123e21451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": false,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "43dd9fd7-3f81-11e6-8a84-bae5000000db",
"value": "отломана деталь"
},
{
"id": "50463893-3f81-11e6-8a84-bae5000000de",
"value": true
}
],
"positions": [
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7a6f697f-3c64-11e6-8a84-bae500000006",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"updated": "2016-07-01 15:16:37",
"name": "00033",
"description": "Гневный возврат бракованного робота",
"code": "k12eer3e21rre451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": true,
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "43dd9fd7-3f81-11e6-8a84-bae5000000db",
"value": "отломана нога"
}
]
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Возвратов покупателя.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"id": "a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 15:16:37",
"name": "0003",
"description": "Гневный возврат бракованного товара",
"code": "k123e21451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "43dd9fd7-3f81-11e6-8a84-bae5000000db",
"name": "Причина возврата",
"type": "string",
"value": "отломана деталь"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "50463893-3f81-11e6-8a84-bae5000000de",
"name": "Брак",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
},
"payedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"id": "a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 15:27:18",
"name": "00033",
"description": "Гневный возврат бракованного робота",
"code": "k12eer3e21rre451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "43dd9fd7-3f81-11e6-8a84-bae5000000db",
"name": "Причина возврата",
"type": "string",
"value": "отломана нога"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "50463893-3f81-11e6-8a84-bae5000000de",
"name": "Брак",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
},
"payedSum": 0
}
]
Удалить Возврат покупателя
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей. |
Запрос на удаление Возврата покупателей с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Возврата покупателей.
Метаданные Возвратов покупателей
Метаданные Возвратов покупателей
Запрос на получение метаданных Возвратов покупателей. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Возвратов покупателей + attributes - Массив объектов доп. полей Возвратов покупателей в формате Метаданных + states - Массив статусов Возвратов покупателей + createShared - создавать новые Возвраты покупателей с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Возвратов покупателей
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Возвратов покупателей.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "43dd9fd7-3f81-11e6-8a84-bae5000000db",
"name": "Причина возврата",
"type": "string",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "50463893-3f81-11e6-8a84-bae5000000de",
"name": "Брак",
"type": "boolean",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073ae24-3f81-11e6-8a84-bae5000000e2",
"type": "state",
"mediaType": "application/json"
},
"id": "7073ae24-3f81-11e6-8a84-bae5000000e2",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Открыт",
"color": 10066329,
"stateType": "Regular",
"entityType": "salesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3",
"type": "state",
"mediaType": "application/json"
},
"id": "7073b255-3f81-11e6-8a84-bae5000000e3",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Выполнен",
"color": 15280409,
"stateType": "Regular",
"entityType": "salesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b5aa-3f81-11e6-8a84-bae5000000e4",
"type": "state",
"mediaType": "application/json"
},
"id": "7073b5aa-3f81-11e6-8a84-bae5000000e4",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Выполнен Частично",
"color": 15106326,
"stateType": "Regular",
"entityType": "salesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b99b-3f81-11e6-8a84-bae5000000e5",
"type": "state",
"mediaType": "application/json"
},
"id": "7073b99b-3f81-11e6-8a84-bae5000000e5",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "На оформлении",
"color": 34617,
"stateType": "Regular",
"entityType": "salesreturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073bd44-3f81-11e6-8a84-bae5000000e6",
"type": "state",
"mediaType": "application/json"
},
"id": "7073bd44-3f81-11e6-8a84-bae5000000e6",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Оформлен",
"color": 9245744,
"stateType": "Regular",
"entityType": "salesreturn"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "50463893-3f81-11e6-8a84-bae5000000de",
"name": "Брак",
"type": "boolean",
"required": false
}
Шаблон возврата покупателя
Шаблон возврата покупателя
Запрос на получение предзаполненого стандартными значениями шаблона возврата покупателя без связи с каким-либо документом.
Создание шаблона возврата покупателя с пустым телом запроса
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного возврата покупателя.
{
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
},
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0
}
Шаблон возврата покупателя на основе
Запрос на получение предзаполненного шаблона возврата покупателя на основе переданной отгрузки. В ответ на запрос вернётся предзаполненный шаблон возврата покупателя, который затем можно будет использовать для создания нового возврата с помощью POST запроса.
Пример запроса на создание шаблона возврата покупателя на основе отгрузки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/3ebb140e-2e62-11e6-8a84-bae500000127",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного Возврата покупателя.
{
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf41a7b-2e58-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
},
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/3ebb140e-2e62-11e6-8a84-bae500000127",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
},
"payedSum": 0
}
Возврат покупателя
Получить Возврат покупателя
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей. |
Запрос на получение отдельного Возврата покупателей с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Возврата покупателей с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"id": "90f337d1-3f80-11e6-8a84-bae5000000ac",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 14:40:10",
"name": "00001",
"externalCode": "PDJ7P5kVhEWomlQtd67up2",
"moment": "2016-07-01 14:39:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 25100,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf41a7b-2e58-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 6,
"limit": 1000,
"offset": 0
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/3ebb140e-2e62-11e6-8a84-bae500000127",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
},
"payedSum": 0
}
Изменить Возврат покупателя
Запрос на обновление Возврата покупателей с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Возврата покупателей, кроме тех, что
помечены Только для чтения в описании атрибутов Возврата покупателей.
При обновлении поля organization нужно также обновить поле organizationAccount иначе произойдёт ошибка.
Контрагент должен совпадать с контрагентом, указанным в документе, по которому создаётся возврат.
При обновлении возврата: + Нельзя изменять следующие поля: agentAccount, agent, demand + Нельзя выставить валюту отличную от валюты в документе + Нельзя добавить позиции, отсутствующие среди позиций документа.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей. |
Пример запроса на обновление Возврата покупателей.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"updated": "2016-07-01 15:16:37",
"name": "00033",
"description": "Гневный возврат бракованного робота",
"code": "k12eer3e21rre451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": true,
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "43dd9fd7-3f81-11e6-8a84-bae5000000db",
"value": "отломана нога"
}
],
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Возврата покупателей.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata",
"type": "salesreturn",
"mediaType": "application/json"
},
"id": "a8b8e1e3-3f85-11e6-8a84-bae50000008d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-01 15:27:18",
"name": "00033",
"description": "Гневный возврат бракованного робота",
"code": "k12eer3e21rre451k",
"externalCode": "w214t2141f",
"moment": "2017-11-21 14:37:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/states/7073b255-3f81-11e6-8a84-bae5000000e3",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/43dd9fd7-3f81-11e6-8a84-bae5000000db",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "43dd9fd7-3f81-11e6-8a84-bae5000000db",
"name": "Причина возврата",
"type": "string",
"value": "отломана нога"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/metadata/attributes/50463893-3f81-11e6-8a84-bae5000000de",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "50463893-3f81-11e6-8a84-bae5000000de",
"name": "Брак",
"type": "boolean",
"value": true
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/a8b8e1e3-3f85-11e6-8a84-bae50000008d/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"demand": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/6b967815-3f84-11e6-8a84-bae5000000ea",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
},
"payedSum": 0
}
Позиции возврата покупателя
Отдельный ресурс для управления позициями Возврата покупателей. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить Позиции
Запрос на получение списка всех позиций данной Возврата покупателей. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Возврата покупателей.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Позиции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций Возврата покупателей.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions",
"type": "salesreturnposition",
"mediaType": "application/json",
"size": 6,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/90f3f201-3f80-11e6-8a84-bae5000000ad",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "90f3f201-3f80-11e6-8a84-bae5000000ad",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 900,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"gtd": {
"name": "12345678/121217/1212321"
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/90f3fc5f-3f80-11e6-8a84-bae5000000ae",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "90f3fc5f-3f80-11e6-8a84-bae5000000ae",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/90f41291-3f80-11e6-8a84-bae5000000af",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "90f41291-3f80-11e6-8a84-bae5000000af",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/90f41a94-3f80-11e6-8a84-bae5000000b0",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "90f41a94-3f80-11e6-8a84-bae5000000b0",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 8600,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/58f32700-3303-11e6-8a84-bae50000853c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"gtd": {
"name": "12345678/121217/1212321"
},
"country": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/country/40e6f69a-991c-4fbc-8be9-d0d906cad180",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/country/metadata",
"type": "country",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/90f4218b-3f80-11e6-8a84-bae5000000b1",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "90f4218b-3f80-11e6-8a84-bae5000000b1",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/67aa1d09-3d19-11e6-8a84-bae50000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/90f427d1-3f80-11e6-8a84-bae5000000b2",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "90f427d1-3f80-11e6-8a84-bae5000000b2",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 16500,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
}
]
}
Создать Позицию
Запрос на создание новой позиции в Возврате покупателя. Для успешного создания необходимо в теле запроса указать следующие поля: + assortmet - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Возврата покупателей. + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Возврата покупателей. Все созданные данным запросом позиции будут добавлены к уже существующим. Нельзя создавать позиции, отличные от позиций в документе, по которому создаётся возврат. Допустимо только отличие в quantity позиций (количество в позиции в возврате м.б. меньше или равно количеству в позиции в документе).
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей. |
Пример запроса на создание позиций в Возврате покупателя.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 900,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 11
},
{
"quantity": 1,
"price": 8600,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/58f32700-3303-11e6-8a84-bae50000853c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 13
},
{
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/67aa1d09-3d19-11e6-8a84-bae50000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 15
},
{
"quantity": 1,
"price": 16500,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 17
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданных позиций.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/ea8f2771-3f82-11e6-8a84-bae50000007f",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "ea8f2771-3f82-11e6-8a84-bae50000007f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 900,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/328b0454-2e62-11e6-8a84-bae500000118",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/ea8f2f2e-3f82-11e6-8a84-bae500000080",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "ea8f2f2e-3f82-11e6-8a84-bae500000080",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/ea8f35ca-3f82-11e6-8a84-bae500000081",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "ea8f35ca-3f82-11e6-8a84-bae500000081",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 11
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/ea8f3bce-3f82-11e6-8a84-bae500000082",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "ea8f3bce-3f82-11e6-8a84-bae500000082",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 8600,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/58f32700-3303-11e6-8a84-bae50000853c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 13
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/ea8f41a9-3f82-11e6-8a84-bae500000083",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "ea8f41a9-3f82-11e6-8a84-bae500000083",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/67aa1d09-3d19-11e6-8a84-bae50000000b",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 15
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/ea8f477b-3f82-11e6-8a84-bae500000084",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "ea8f477b-3f82-11e6-8a84-bae500000084",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 16500,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 17
}
]
Позиция Возврата покупателя
Получить Позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Возврата покупателей. |
Запрос на получение отдельной позиции Возврата покупателей с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Возврата покупателей.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/90f41291-3f80-11e6-8a84-bae5000000af",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "90f41291-3f80-11e6-8a84-bae5000000af",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/4f785efd-3304-11e6-8a84-bae50001c6c4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 10
}
Изменить Позицию
Запрос на обновление отдельной позиции Возврата покупателей. При обновлении отдельной позиции в возврате можно только изменить количество данной позиции. Причём это количество должно быть в пределах , где n - кол-во данной позиции в документе, по которому создан возврат.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Возврата покупателей. |
Пример запроса на обновление отдельной позиции в Возврате покупателя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 1,
"price": 16500,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 100
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Возврата покупателей.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/90f337d1-3f80-11e6-8a84-bae5000000ac/positions/ea8f477b-3f82-11e6-8a84-bae500000084",
"type": "salesreturnposition",
"mediaType": "application/json"
},
"id": "ea8f477b-3f82-11e6-8a84-bae500000084",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 16500,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0ae4836f-3303-11e6-8a84-bae500000d39",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cost": 100
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата покупателей. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Возврата покупателей. |
Запрос на удаление отдельной позиции Возврата покупателей с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/salesreturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Возврата покупателей.
Документ Возврат поставщику
Средствами JSON API можно создавать и обновлять сведения о Возвратах поставщикам, запрашивать списки Возвратов поставщикам и сведения по отдельным Возвратам поставщикам. Позициями Возвратов поставщикам можно управлять как в составе отдельного Возврата, так и отдельно - с помощью специальных ресурсов для управления позициями Возврата поставщику. Кодом сущности для Возврата поставщику в составе JSON API является ключевое слово purchasereturn.
Возвраты поставщикам
Атрибуты сущности
- meta - Метаданные о Возврате поставщику
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Возврата поставщику
- description - Комментарий Возврата поставщику
- externalCode - Внешний код Возврата поставщику
- moment - Дата Возврата поставщику
- applicable - Отметка о проведении
- vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- sum - Сумма Возврата поставщику в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
- store - Ссылка на склад в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
- project - Ссылка на проект в формате Метаданных
- state - Статус Возврата поставщику в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения#### Связи с другими документами - positions - Ссылка на позиции Возврата поставщику в формате Метаданных
- supply - Ссылка на приёмку, по которой произошёл возврат в формате Метаданных Поле является необходимым для возврата с основанием.
- factureOut - Ссылка на счет-фактура выданный в формате Метаданных
- payedSum - Сумма входящих платежей по возврату поставщику
- payments - Массив ссылок на связанные платежи в формате Метаданных
Позиции Возврата поставщику
Позиции Возврата поставщику - это список товаров/услуг/модификаций/серий.
Объект позиции Возврата поставщику содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ discount - Процент скидки или наценки. Должен совпадать с указанным в приёмке (игнорируется для возвратов без основания)
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ things - Серийные номера
Значение данного атрибута игнорируется, если товар позиции не находится на серийном учете.
В ином случае количество товаров в позиции будет равно количеству серийных номеров, переданных в значении атрибута.
С позициями можно работать с помощью специальных ресурсов для управления позициями Возврата поставщику, а также в составе отдельного Возврата поставщику. При работе в составе отдельного Возврата поставщику, вы можете отправлять запросы на создание отдельного Возврата поставщику с включенным в тело запроса массивом позиций Возврата поставщику. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Возврата поставщику". Также, при работе в составе отдельного Возврата поставщику, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Возврата поставщику. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Возврата поставщику" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Возвратов поставщикамых возвратов можно прочитать здесь
Получить Возвраты поставщикам
Запрос всех Возвратов поставщикам на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Возвраты поставщикам.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Возвраты поставщикам
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Возвратов поставщикам.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/b875cc8f-313f-11e6-8a84-bae500000093",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "b875cc8f-313f-11e6-8a84-bae500000093",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-13 11:20:55",
"name": "00001",
"externalCode": "E4l6sMtVixklOjgfK6VQt3",
"moment": "2016-06-13 11:20:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf44002-2e58-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/b875cc8f-313f-11e6-8a84-bae500000093/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/b1008773-313f-11e6-8a84-bae500000089",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/d43161ea-3140-11e6-8a84-bae5000000c6",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "d43161ea-3140-11e6-8a84-bae5000000c6",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-06-13 11:28:34",
"name": "00002",
"externalCode": "-5xto6PjiGhuL8RAky-9c3",
"moment": "2016-06-13 11:22:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 273000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/faf44002-2e58-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/d43161ea-3140-11e6-8a84-bae5000000c6/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/f39a60f5-313f-11e6-8a84-bae5000000b4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/dc194230-41bd-11e6-8a84-bae5000000a9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "dc194230-41bd-11e6-8a84-bae5000000a9",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 11:03:57",
"name": "00003",
"externalCode": "-SmYzmhBjSFQBveIJQ6uV0",
"moment": "2016-07-04 11:03:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 28000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/2b34d43f-3f52-11e6-8a84-bae500000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1489a08d-32ca-11e6-8a84-bae50000000d/accounts/1489ad8d-32ca-11e6-8a84-bae50000000e",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/dc194230-41bd-11e6-8a84-bae5000000a9/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 7,
"limit": 1000,
"offset": 0
}
},
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/ceec2ca6-41bd-11e6-8a84-bae500000097",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "e699b298-41bd-11e6-8a84-bae5000000ba",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 11:04:15",
"name": "00004",
"externalCode": "tBSZzXSgggWNL5MZ7IrYE2",
"moment": "2016-07-04 11:04:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 43156000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/91287d9a-41bc-11e6-8a84-bae500000082",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/14bfc067-32ca-11e6-8a84-bae50000003f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 7,
"limit": 1000,
"offset": 0
}
},
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/80d04ebc-41bd-11e6-8a84-bae500000085",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
}
]
}
Создать Возврат поставщику
Обязательные поля при создании нового Возврата поставщику: + name - Номер возврата + organization - Ссылка на ваше юрлицо в формате Метаданных + store - Ссылка на склад в формате Метаданных + supply - Ссылка на приёмку, по которой произошёл возврат в формате Метаданных, обязательное поле только для возврата по основанию + agent - Ссылка на контрагента в формате Метаданных Контрагент, указанный в запросе на создание возврата, должен совпадать с контрагентом, указанном в документе, по которому создаётся возврат.
При создании возврата: + При создании возврата без основания поле supply указывать не нужно + Контрагент в возврате и в документе, по которому он создаётся, должны совпадать + Валюта и юрлицо в возврате и в документе так же должны совпадать + При передаче коллекции positions в теле запроса на создание возврата, передаваемые позиции должны соответствовать позициям в документе. Различие может быть только в количестве товара в позиции (меньшее либо равное количеству в документе). Нельзя передать позиции, которых нет в документе.
Пример создания нового Возврата поставщику на основании приемки.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "77887",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"description": "Возврат поставщику созданный через API",
"code": "8865255398",
"externalCode": "fruitsareawesome124",
"moment": "2016-11-21 14:37:00",
"applicable": true,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"value": "отломана деталь"
},
{
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"value": false
}
],
"positions": [
{
"quantity": 1,
"price": 1241200,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e6447ee7-3303-11e6-8a84-bae5000149c2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 24100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8517bc4-3303-11e6-8a84-bae500014de1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/6767bc73-3d19-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 2421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8563cc5-3303-11e6-8a84-bae500014df0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/7585391b-41c0-11e6-8a84-bae5000000de",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Возврата поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "6d5371fc-41c1-11e6-8a84-bae50000001c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 11:29:29",
"name": "77887",
"description": "Возврат поставщику созданный через API",
"code": "8865255398",
"externalCode": "fruitsareawesome124",
"moment": "2016-11-21 14:37:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4107300,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e124-41be-11e6-8a84-bae5000000cb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"name": "Брак продукции",
"type": "boolean",
"value": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"name": "Причина, отличная от брака",
"type": "text",
"value": "отломана деталь"
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/7585391b-41c0-11e6-8a84-bae5000000de",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
}
Пример создания нового Возврата поставщику без основания.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "77887",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"description": "Возврат поставщику созданный через API",
"code": "8865255398",
"externalCode": "fruitsareawesome124",
"moment": "2016-11-21 14:37:00",
"applicable": true,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"value": "отломана деталь"
},
{
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"value": false
}
],
"positions": [
{
"quantity": 1,
"price": 1241200,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e6447ee7-3303-11e6-8a84-bae5000149c2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 24100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8517bc4-3303-11e6-8a84-bae500014de1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/6767bc73-3d19-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 2421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8563cc5-3303-11e6-8a84-bae500014df0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Возврата поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "6d5371fc-41c1-11e6-8a84-bae50000001c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 11:29:29",
"name": "77887",
"description": "Возврат поставщику созданный через API",
"code": "8865255398",
"externalCode": "fruitsareawesome124",
"moment": "2016-11-21 14:37:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4107300,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e124-41be-11e6-8a84-bae5000000cb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"name": "Брак продукции",
"type": "boolean",
"value": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"name": "Причина, отличная от брака",
"type": "text",
"value": "отломана деталь"
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 4,
"limit": 100,
"offset": 0
}
},
"payedSum": 0
}
Массовое создание и обновление Возвратов поставщику
Массовое создание и обновление Возвратов поставщику. В теле запроса нужно передать массив, содержащий JSON представления Возвратов поставщику, которые вы хотите создать или обновить. Обновляемые Возвраты поставщику должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Возвратов поставщику
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "77887",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"description": "Возврат поставщику созданный через API",
"code": "8865255398",
"externalCode": "fruitsareawesome124",
"moment": "2016-11-21 14:37:00",
"applicable": true,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"value": "отломана деталь"
},
{
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"value": false
}
],
"positions": [
{
"quantity": 1,
"price": 1241200,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e6447ee7-3303-11e6-8a84-bae5000149c2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 24100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8517bc4-3303-11e6-8a84-bae500014de1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/6767bc73-3d19-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 2421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8563cc5-3303-11e6-8a84-bae500014df0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/7585391b-41c0-11e6-8a84-bae5000000de",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"name": "763457",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/1205364b-7f01-455a-a1b5-4ba0988c8308",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/348d910b-6dc0-483f-b916-2237bc54a04e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"description": "Возврат поставщику созданный и обновлённый через API",
"code": "8865255398",
"externalCode": "fruitsareawesome!!!",
"moment": "2016-11-21 14:27:00",
"applicable": false,
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/states/69e39d04-41be-11e6-8a84-bae5000000d2",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"value": true
}
],
"positions": [
{
"quantity": 1,
"price": 1241200,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e6447ee7-3303-11e6-8a84-bae5000149c2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 24100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8517bc4-3303-11e6-8a84-bae500014de1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/6767bc73-3d19-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 2421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8563cc5-3303-11e6-8a84-bae500014df0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 263000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Возвратов поставщику.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "6d5371fc-41c1-11e6-8a84-bae50000001c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 11:29:29",
"name": "77887",
"description": "Возврат поставщику созданный через API",
"code": "8865255398",
"externalCode": "fruitsareawesome124",
"moment": "2016-11-21 14:37:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4107300,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e124-41be-11e6-8a84-bae5000000cb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"name": "Брак продукции",
"type": "boolean",
"value": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"name": "Причина, отличная от брака",
"type": "text",
"value": "отломана деталь"
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 4,
"limit": 1000,
"offset": 0
}
},
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/7585391b-41c0-11e6-8a84-bae5000000de",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "6d5371fc-41c1-11e6-8a84-bae50000001c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/1205364b-7f01-455a-a1b5-4ba0988c8308",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/348d910b-6dc0-483f-b916-2237bc54a04e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 11:35:26",
"name": "763457",
"description": "Возврат поставщику созданный и обновлённый через API",
"code": "8865255398",
"externalCode": "fruitsareawesome!!!",
"moment": "2016-11-21 14:27:00",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4370300,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/states/69e39d04-41be-11e6-8a84-bae5000000d2",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e124-41be-11e6-8a84-bae5000000cb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"name": "Брак продукции",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"name": "Причина, отличная от брака",
"type": "text",
"value": "отломана деталь"
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
},
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/7585391b-41c0-11e6-8a84-bae5000000de",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
}
]
Удалить Возврат поставщику
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата поставщику. |
Запрос на удаление Возврата поставщику с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Возврата поставщику.
Метаданные Возвратов поставщикам
Метаданные Возвратов поставщикам
Запрос на получение метаданных Возвратов поставщикам. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Возвратов поставщикам + attributes - Массив объектов доп. полей Возвратов поставщикам в формате Метаданных + states - Массив статусов Возвратов поставщикам + createShared - создавать новые Возвраты поставщикам с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Возвратов поставщикам
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Возвратов поставщикам.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e124-41be-11e6-8a84-bae5000000cb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"name": "Брак продукции",
"type": "boolean",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"name": "Причина, отличная от брака",
"type": "text",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/states/69e394ff-41be-11e6-8a84-bae5000000d0",
"type": "state",
"mediaType": "application/json"
},
"id": "69e394ff-41be-11e6-8a84-bae5000000d0",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Оформлен",
"color": 9245744,
"stateType": "Regular",
"entityType": "purchasereturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/states/69e39958-41be-11e6-8a84-bae5000000d1",
"type": "state",
"mediaType": "application/json"
},
"id": "69e39958-41be-11e6-8a84-bae5000000d1",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Произведён частично",
"color": 4354177,
"stateType": "Regular",
"entityType": "purchasereturn"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/states/69e39d04-41be-11e6-8a84-bae5000000d2",
"type": "state",
"mediaType": "application/json"
},
"id": "69e39d04-41be-11e6-8a84-bae5000000d2",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Произведён",
"color": 8825440,
"stateType": "Regular",
"entityType": "purchasereturn"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"name": "Причина, отличная от брака",
"type": "text",
"required": false
}
Шаблон возврата поставщику
Шаблон возврата поставщику
Запрос на получение предзаполненого стандартными значениями шаблона возврата поставщику без связи с каким-либо документом.
Создание шаблона возврата поставщику с пустым телом запроса
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного Возврата поставщику.
{
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
},
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"payedSum": 0
}
Шаблон возврата поставщику на основе
Запрос на получение предзаполненного шаблона возврата поставщику на основе переданной приёмки. В ответ на запрос вернётся предзаполненный шаблон возврата поставщику, который затем можно будет использовать для создания нового возврата с помощью POST запроса.
Пример запроса на создание шаблона возврата поставщику на основе приёмки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/373d2925-4a98-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного Возврата поставщику.
{
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/1485d676-32ca-11e6-8a84-bae500000009/accounts/1485e43e-32ca-11e6-8a84-bae50000000a",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
},
"rows": []
},
"vatEnabled": true,
"vatIncluded": true,
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/373d2925-4a98-11e6-8a84-bae500000069",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
}
Возврат поставщику
Получить Возврат поставщику
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата поставщику. |
Запрос на получение отдельного Возврата поставщику с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Возврата поставщику с указанным id.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "e699b298-41bd-11e6-8a84-bae5000000ba",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 11:04:15",
"name": "00004",
"externalCode": "tBSZzXSgggWNL5MZ7IrYE2",
"moment": "2016-07-04 11:04:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 43156000,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/91287d9a-41bc-11e6-8a84-bae500000082",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/722e39f0-313e-11e6-8a84-bae500000008",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/14bfc067-32ca-11e6-8a84-bae50000003f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"vatEnabled": true,
"vatIncluded": true,
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 7,
"limit": 1000,
"offset": 0
}
},
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/80d04ebc-41bd-11e6-8a84-bae500000085",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
}
Изменить Возврат поставщику
Запрос на обновление Возврата поставщику с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Возврата поставщику, кроме тех, что
помечены Только для чтения в описании атрибутов Возврата поставщику.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
Контрагент должен совпадать с контрагентом, указанным в документе, по которому создаётся возврат.
При обновлении возврата: + Нельзя изменять следующие поля: agentAccount, agent, supply + Нельзя выставить валюту отличную от валюты в документе + Нельзя добавить позиции, отсутствующие среди позиций документа.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата поставщику. |
Пример запроса на обновление Возврата поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "763457",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/1205364b-7f01-455a-a1b5-4ba0988c8308",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/348d910b-6dc0-483f-b916-2237bc54a04e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"description": "Возврат поставщику созданный и обновлённый через API",
"code": "8865255398",
"externalCode": "fruitsareawesome!!!",
"moment": "2016-11-21 14:27:00",
"applicable": false,
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/states/69e39d04-41be-11e6-8a84-bae5000000d2",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"value": true
}
],
"positions": [
{
"quantity": 1,
"price": 1241200,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e6447ee7-3303-11e6-8a84-bae5000149c2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 24100,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8517bc4-3303-11e6-8a84-bae500014de1",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/6767bc73-3d19-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 2421000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8563cc5-3303-11e6-8a84-bae500014df0",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 263000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Возврата поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json"
},
"id": "6d5371fc-41c1-11e6-8a84-bae50000001c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/1205364b-7f01-455a-a1b5-4ba0988c8308",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/348d910b-6dc0-483f-b916-2237bc54a04e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-07-04 11:35:26",
"name": "763457",
"description": "Возврат поставщику созданный и обновлённый через API",
"code": "8865255398",
"externalCode": "fruitsareawesome!!!",
"moment": "2016-11-21 14:27:00",
"applicable": false,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4370300,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/faf3ff5b-2e58-11e6-8a84-bae500000050",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/states/69e39d04-41be-11e6-8a84-bae5000000d2",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/fae3561a-2e58-11e6-8a84-bae50000004e/accounts/fae39d66-2e58-11e6-8a84-bae50000004f",
"type": "account",
"mediaType": "application/json"
}
},
"agentAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/147c1f1b-32ca-11e6-8a84-bae500000004/accounts/147c3231-32ca-11e6-8a84-bae500000005",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e124-41be-11e6-8a84-bae5000000cb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e124-41be-11e6-8a84-bae5000000cb",
"name": "Брак продукции",
"type": "boolean",
"value": true
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata/attributes/4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4fc7e7e7-41be-11e6-8a84-bae5000000cc",
"name": "Причина, отличная от брака",
"type": "text",
"value": "отломана деталь"
}
],
"vatEnabled": true,
"vatIncluded": true,
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/6d5371fc-41c1-11e6-8a84-bae50000001c/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
},
"supply": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/7585391b-41c0-11e6-8a84-bae5000000de",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
},
"payedSum": 0
}
Позиции Возврата поставщику
Отдельный ресурс для управления позициями Возврата поставщику. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить Позиции
Запрос на получение списка всех позиций данной Возврата поставщику. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Возврата поставщику.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата поставщику. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить Позиции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций Возврата поставщику.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions",
"type": "purchasereturnposition",
"mediaType": "application/json",
"size": 7,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/e699bc75-41bd-11e6-8a84-bae5000000bb",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "e699bc75-41bd-11e6-8a84-bae5000000bb",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 40,
"price": 34400,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/a69fe5c3-3303-11e6-8a84-bae50000dfab",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/e699c2b5-41bd-11e6-8a84-bae5000000bc",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "e699c2b5-41bd-11e6-8a84-bae5000000bc",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 52,
"price": 556000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0464a192-3304-11e6-8a84-bae500017f51",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/e699c804-41bd-11e6-8a84-bae5000000bd",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "e699c804-41bd-11e6-8a84-bae5000000bd",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 32,
"price": 200000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/044e812a-3304-11e6-8a84-bae500017f34",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/e699cd72-41bd-11e6-8a84-bae5000000be",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "e699cd72-41bd-11e6-8a84-bae5000000be",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 112,
"price": 34000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/048b1a8b-3304-11e6-8a84-bae500017f84",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/e699d288-41bd-11e6-8a84-bae5000000bf",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "e699d288-41bd-11e6-8a84-bae5000000bf",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 76,
"price": 35000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/27eba7b5-3303-11e6-8a84-bae500002b72",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/e699d76d-41bd-11e6-8a84-bae5000000c0",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "e699d76d-41bd-11e6-8a84-bae5000000c0",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 6000,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/130a02d7-3303-11e6-8a84-bae500001887",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/e699dcb4-41bd-11e6-8a84-bae5000000c1",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "e699dcb4-41bd-11e6-8a84-bae5000000c1",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 75,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0475cacb-3303-11e6-8a84-bae500000765",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
Создать Позицию
Запрос на создание новой позиции в Возврате поставщику. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Возврата поставщику. + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Возврата поставщику. Все созданные данным запросом позиции будут добавлены к уже существующим. Нельзя создавать позиции, отличные от позиций в документе, по которому создаётся возврат. Допустимо только отличие в quantity позиций (количество в позиции в возврате м.б. меньше или равно количеству в позиции в документе).
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата поставщику. |
Пример запроса на создание позиций в Возврате поставщику.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 1,
"price": 263000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 10000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0744d71b-2e59-11e6-8a84-bae50000007f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданных позиций.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/9cfa8b56-41bf-11e6-8a84-bae500000014",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "9cfa8b56-41bf-11e6-8a84-bae500000014",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 263000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/20485cfd-2e62-11e6-8a84-bae500000112",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/9cfa9b0e-41bf-11e6-8a84-bae500000015",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "9cfa9b0e-41bf-11e6-8a84-bae500000015",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 1,
"price": 10000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/0744d71b-2e59-11e6-8a84-bae50000007f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
Позиция Возврата поставщику
Получить Позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата поставщику. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Возврата поставщику. |
Запрос на получение отдельной позиции Возврата поставщику с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Возврата поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/e699d288-41bd-11e6-8a84-bae5000000bf",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "e699d288-41bd-11e6-8a84-bae5000000bf",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 76,
"price": 35000,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/27eba7b5-3303-11e6-8a84-bae500002b72",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Изменить Позицию
Запрос на обновление отдельной позиции Возврата поставщику. При обновлении отдельной позиции в возврате можно только изменить количество данной позиции. Причём это количество должно быть в пределах , где n - кол-во данной позиции в документе, по которому создан возврат.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата поставщику. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Возврата поставщику. |
Пример запроса на обновление отдельной позиции в Возврате поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 6754
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Возврата поставщику.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/e699b298-41bd-11e6-8a84-bae5000000ba/positions/e699d76d-41bd-11e6-8a84-bae5000000c0",
"type": "purchasereturnposition",
"mediaType": "application/json"
},
"id": "e699d76d-41bd-11e6-8a84-bae5000000c0",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"quantity": 6754,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/130a02d7-3303-11e6-8a84-bae500001887",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Возврата поставщику. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Возврата поставщику. |
Запрос на удаление отдельной позиции Возврата поставщику с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Возврата поставщику.
Документ Счет-фактура выданный
Счета-фактуры выданные
Средствами JSON API можно создавать и изменять Счет-фактуры выданные, запрашивать списки выданных Счетов-фактур, сведения по отдельным Счетам-фактурам и удалять Счета-фактуры. Счет-фактура может быть создана только на основании отгрузки, возврата поставщику или входящего платежа, без документа-основания счет-фактуру создать нельзя. Кодом сущности для выданного Счета-фактуры в составе JSON API является ключевое слово factureout.
Атрибуты сущности
- meta - Метаданные о выданном Счете-фактуре
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер выданного Счета-фактуры
- description - Комментарий выданного Счета-фактуры
- externalCode - Внешний код выданного Счета-фактуры
- moment - Дата выданного Счета-фактуры
- applicable - Отметка о проведении
- sum - Сумма выданного Счета-фактуры в установленной валюте
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Только для чтения - agent - Ссылка на контрагента в формате Метаданных
Только для чтения - contract - Ссылка на договор в формате Метаданных
- state - Статус выданного Счета-фактуры в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - stateContractId - Идентификатор государственного контракта, договора (соглашения)
Связи с другими документами
- demands - Массив ссылок на связанные отгрузки в формате Метаданных
- meta - Ссылка на отгрузку, к которой привязан этот Счет-фактура в формате метаданных
- payments - Массив ссылок на связанные входящие платежи в формате Метаданных
- meta - Ссылка на входящий платеж, к которой привязан этот Счет-фактура в формате метаданных
- returns - Массив ссылок на связанные возвраты поставщикам в формате Метаданных
- meta - Ссылка на возврат поставщику, к которой привязан этот Счет-фактура в формате метаданных
Другие поля
- consignee - Грузополучатель
- paymentNumber - Название платежного документа
- paymentDate - Дата платежного документа
О работе с доп. полями Счет-фактур можно прочитать здесь
Получить выданные Счета-фактуры
Запрос всех выданных Счетов-фактур на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой выданные Счета-фактуры.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить выданные Счета-фактуры
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/factureout"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка выданных Счетов-фактур.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "factureout",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/02eb1458-aa6e-11e6-8a84-bc5200000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "factureout",
"mediaType": "application/json"
},
"id": "02eb1458-aa6e-11e6-8a84-bc5200000076",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-14 16:38:48",
"name": "00001",
"description": "комментарий",
"externalCode": "pb8w9ZcVhQbFff4R58SQ30",
"moment": "2016-11-14 16:25:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/217065c0-9b50-11e6-8a84-bc52000000bf",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 60
},
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/f1204d87-9c46-11e6-8a84-bc52000000b9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/states/e1115474-aa6e-11e6-8a84-bc520000007c",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/attributes/8b0b6c1d-aa6f-11e6-8a84-bc520000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "8b0b6c1d-aa6f-11e6-8a84-bc520000008a",
"name": "доп поле",
"type": "string",
"value": "значение доп.поля"
}
],
"paymentNumber": "платежный д-т",
"paymentDate": "2016-11-14 00:00:00",
"stateContractId": "005674",
"consignee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/f2570f6a-aa6d-11e6-8a84-bc520000006f",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
}
]
}
Создать Счет-фактуру
Запрос на создание Счета-фактуры на основании отгрузки, входящего платежа или возврата поставщику. Документ-основание должен быть указан в единственном экземпляре. Для установки paymentNumber, paymentDate значения должны быть переданы в теле Json, так как перечисленные поля не заполняются из документа-основания.
Пример создания нового Счета-фактуры, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/factureout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/a95dbc95-24e0-11e7-1542-821d00000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счета-фактуры.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/fa610268-2b5d-11e7-1542-821d00000010",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "factureout",
"mediaType": "application/json"
},
"id": "fa610268-2b5d-11e7-1542-821d00000010",
"accountId": "f4917c99-2346-11e7-1542-821d00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f500c39b-2346-11e7-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f49447eb-2346-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-04-27 18:27:08",
"name": "00001",
"externalCode": "KAwh2VT7hIzHDWQoIcfvS0",
"moment": "2017-04-27 18:27:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/f52dd97c-2346-11e7-1542-821d00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/f52d95dd-2346-11e7-1542-821d00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/f52a29b3-2346-11e7-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-04-27 18:27:09",
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/a95dbc95-24e0-11e7-1542-821d00000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
}
Массовое создание и обновление выданных Счетов-фактур
Массовое создание и обновление выданных Счетов-фактур. В теле запроса нужно передать массив, содержащий JSON представления выданных Счетов-фактур, которые вы хотите создать или обновить. Обновляемые выданные Счета-фактуры должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких выданных Счетов-фактур
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/factureout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/a95dbc95-24e0-11e7-1542-821d00000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/99d41b01-aa8a-11e6-8af5-581e0000007e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "factureout",
"mediaType": "application/json"
},
"name": "FactureOut2"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных выданных Счетов-фактур.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/fa610268-2b5d-11e7-1542-821d00000010",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "factureout",
"mediaType": "application/json"
},
"id": "fa610268-2b5d-11e7-1542-821d00000010",
"accountId": "f4917c99-2346-11e7-1542-821d00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f500c39b-2346-11e7-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f49447eb-2346-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-04-27 18:27:08",
"name": "00001",
"externalCode": "KAwh2VT7hIzHDWQoIcfvS0",
"moment": "2017-04-27 18:27:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/f52dd97c-2346-11e7-1542-821d00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/f52d95dd-2346-11e7-1542-821d00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/f52a29b3-2346-11e7-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-04-27 18:27:09",
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/a95dbc95-24e0-11e7-1542-821d00000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/99d41b01-aa8a-11e6-8af5-581e0000007e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "factureout",
"mediaType": "application/json"
},
"id": "99d41b01-aa8a-11e6-8af5-581e0000007e",
"accountId": "f4917c99-2346-11e7-1542-821d00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f500c39b-2346-11e7-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f49447eb-2346-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-04-27 18:36:36",
"name": "FactureOut2",
"externalCode": "KAwh2VT7hIzHDWQoIcfvS0",
"moment": "2017-04-27 18:27:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/f52dd97c-2346-11e7-1542-821d00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/f52d95dd-2346-11e7-1542-821d00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/f52a29b3-2346-11e7-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-04-27 18:27:09",
"stateContractId": "005674",
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/a95dbc95-24e0-11e7-1542-821d00000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
}
]
Метаданные выданных Счетов-фактур
Метаданные Счетов-фактур
Запрос на получение метаданных выданных Счетов-фактур. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные выданных Счетов-фактур + attributes - Массив объектов доп. полей выданных Счетов-фактур в формате Метаданных + states - Массив статусов выданных Счетов-фактур + createShared - создавать новые выданные Счета-фактуры с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные выданных Счетов-фактур
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей выданных Счетов-фактур.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/attributes/8b0b6c1d-aa6f-11e6-8a84-bc520000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "8b0b6c1d-aa6f-11e6-8a84-bc520000008a",
"name": "доп поле",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/states/e1115474-aa6e-11e6-8a84-bc520000007c",
"type": "state",
"mediaType": "application/json"
},
"id": "e1115474-aa6e-11e6-8a84-bc520000007c",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"name": "rewtret",
"color": 10066329,
"stateType": "Regular",
"entityType": "factureout"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 8b0b6c1d-aa6f-11e6-8a84-bc520000008a id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/attributes/8b0b6c1d-aa6f-11e6-8a84-bc520000008a"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/attributes/8b0b6c1d-aa6f-11e6-8a84-bc520000008a",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "8b0b6c1d-aa6f-11e6-8a84-bc520000008a",
"name": "доп поле",
"type": "string",
"required": false
}
### Шаблон выданного Счета-фактуры
Шаблон выданного Счета-фактуры на основе
Запрос на получение предзаполненного шаблона выданного Счета-фактуры на основе отгрузки, возврата поставщику или входящего платежа. В ответ на запрос вернётся предзаполненный шаблон выданного Счета-фактуры, который затем можно будет использовать для создания нового Счета-фактуры с помощью POST запроса.
Пример запроса на создание шаблона выданного Счета-фактуры на основе отгрузки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/factureout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/fb3e5ec6-66cc-11e7-6adb-ede5000000be",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного выданного Счета-фактуры.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/498a0445-66cc-11e7-6adb-ede50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=498a0445-66cc-11e7-6adb-ede50000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/48f21833-66cc-11e7-6adb-ede500000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2017-07-20 14:54:48",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/49b4b0b0-66cc-11e7-6adb-ede500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=49b4b0b0-66cc-11e7-6adb-ede500000058"
}
}
},
"sum": 10000,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/49b43cd5-66cc-11e7-6adb-ede500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=49b43cd5-66cc-11e7-6adb-ede500000056"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/49b00bbc-66cc-11e7-6adb-ede500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=49b00bbc-66cc-11e7-6adb-ede500000051"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/states/82d0741a-6abc-11e7-6adb-ede50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "state",
"mediaType": "application/json"
}
},
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/fb3e5ec6-66cc-11e7-6adb-ede5000000be",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#demand/edit?id=fb3e5ec6-66cc-11e7-6adb-ede5000000be"
}
}
]
}
Пример запроса на создание шаблона выданного Счета-фактуры на основе возврата поставщику.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/factureout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"returns": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/62ebf0be-67d8-11e7-6adb-ede500000033",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#purchasereturn/edit?id=62ebf0be-67d8-11e7-6adb-ede500000033"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного выданного Счета-фактуры.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/498a0445-66cc-11e7-6adb-ede50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=498a0445-66cc-11e7-6adb-ede50000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/48f21833-66cc-11e7-6adb-ede500000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2017-07-20 15:26:40",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/49b4b0b0-66cc-11e7-6adb-ede500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=49b4b0b0-66cc-11e7-6adb-ede500000058"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/49b40d55-66cc-11e7-6adb-ede500000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=49b40d55-66cc-11e7-6adb-ede500000054"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/49b00bbc-66cc-11e7-6adb-ede500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=49b00bbc-66cc-11e7-6adb-ede500000051"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/states/82d0741a-6abc-11e7-6adb-ede50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "state",
"mediaType": "application/json"
}
},
"returns": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/62ebf0be-67d8-11e7-6adb-ede500000033",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchasereturn/metadata",
"type": "purchasereturn",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#purchasereturn/edit?id=62ebf0be-67d8-11e7-6adb-ede500000033"
}
}
]
}
Пример запроса на создание шаблона выданного Счета-фактуры на основе входящего платежа.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/factureout/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"payments": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/f69cb6ec-6d45-11e7-6adb-ede50000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#paymentin/edit?id=f69cb6ec-6d45-11e7-6adb-ede50000001c"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного выданного Счета-фактуры.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/498a0445-66cc-11e7-6adb-ede50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=498a0445-66cc-11e7-6adb-ede50000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/48f21833-66cc-11e7-6adb-ede500000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2017-07-20 15:25:09",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/49b4b0b0-66cc-11e7-6adb-ede500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=49b4b0b0-66cc-11e7-6adb-ede500000058"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/35950354-6ae5-11e7-6adb-ede500000036",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=35950354-6ae5-11e7-6adb-ede500000036"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/49b00bbc-66cc-11e7-6adb-ede500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=49b00bbc-66cc-11e7-6adb-ede500000051"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/states/82d0741a-6abc-11e7-6adb-ede50000000e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "state",
"mediaType": "application/json"
}
},
"payments": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/f69cb6ec-6d45-11e7-6adb-ede50000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#paymentin/edit?id=f69cb6ec-6d45-11e7-6adb-ede50000001c"
}
}
]
}
Счет-фактура выданный
Получить выданный Счет-фактуру
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 99d41b01-aa8a-11e6-8af5-581e0000007e id Счета-фактуры. |
Запрос на получение отдельного выданного Счета-фактуры с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/factureout/99d41b01-aa8a-11e6-8af5-581e0000007e"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление выданного Счета-фактуры.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/99d41b01-aa8a-11e6-8af5-581e0000007e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "factureout",
"mediaType": "application/json"
},
"id": "99d41b01-aa8a-11e6-8af5-581e0000007e",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-14 19:52:25",
"name": "00001",
"externalCode": "iXXMP3d-gJI8avpfWsDAU3",
"moment": "2016-11-08 17:26:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9596f69c-9609-11e6-8af5-581e000000d9",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/states/9770ee98-aa8a-11e6-8af5-581e0000007b",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata/attributes/3aa46d91-aa8a-11e6-8af5-581e00000077",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "3aa46d91-aa8a-11e6-8af5-581e00000077",
"name": "special_description",
"type": "string",
"value": "jih"
}
],
"stateContractId": "005674",
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/750c8f8e-a5bf-11e6-8af5-581e000000bc",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
}
Изменить выданный Счет-фактуру
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 99d41b01-aa8a-11e6-8af5-581e0000007e id Счета-фактуры. |
Запрос на обновление Счета-фактуры с указанным id.
Пример запроса на обновление Счет-фактуры.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/factureout/99d41b01-aa8a-11e6-8af5-581e0000007e"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "FactureOut2"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Счета-фактуры.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/99d41b01-aa8a-11e6-8af5-581e0000007e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/factureout/metadata",
"type": "factureout",
"mediaType": "application/json"
},
"id": "99d41b01-aa8a-11e6-8af5-581e0000007e",
"accountId": "f4917c99-2346-11e7-1542-821d00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f500c39b-2346-11e7-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f49447eb-2346-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-04-27 18:36:36",
"name": "FactureOut2",
"externalCode": "KAwh2VT7hIzHDWQoIcfvS0",
"moment": "2017-04-27 18:27:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/f52dd97c-2346-11e7-1542-821d00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/f52d95dd-2346-11e7-1542-821d00000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/f52a29b3-2346-11e7-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-04-27 18:27:09",
"stateContractId": "005674",
"demands": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/demand/a95dbc95-24e0-11e7-1542-821d00000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/demand/metadata",
"type": "demand",
"mediaType": "application/json"
}
}
]
}
Удалить выданный Счет-фактуру
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b20 id Счета-фактуры. |
Запрос на удаление выданного Счета-фактуры с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/factureout/7944ef04-f831-11e5-7a69-971500188b20"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление выданного Счета-фактуры.
Документ Счет-фактура полученный
Счета-фактуры полученные
Средствами JSON API можно создавать и изменять Счет-фактуры полученные, запрашивать списки полученных Счетов-фактур, сведения по отдельным Счетам-фактурам и удалять Счета-фактуры. Счет-фактура может быть создана только на основании приемки или исходящего платежа, без документа-основания счет-фактуру создать нельзя. Кодом сущности для полученного Счета-фактуры в составе JSON API является ключевое слово facturein.
Атрибуты сущности
- meta - Метаданные о полученном Счете-фактуре
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер полученного Счета-фактуры
- description - Комментарий полученного Счета-фактуры
- externalCode - Внешний код полученного Счета-фактуры
- moment - Дата полученного Счета-фактуры
- applicable - Отметка о проведении
- sum - Сумма полученного Счета-фактуры в установленной валюте
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Только для чтения - agent - Ссылка на контрагента в формате Метаданных
Только для чтения - contract - Ссылка на договор в формате Метаданных
- state - Статус полученного Счета-фактуры в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения
Связи с другими документами
- supplies - Массив ссылок на связанные приемки в формате Метаданных
- meta - Ссылка на приемку, к которой привязан этот Счет-фактура в формате метаданных
- payments - Массив ссылок на связанные исходящие платежи в формате Метаданных
- meta - Ссылка на исходящий платеж, к которой привязан этот Счет-фактура в формате метаданных
Другие поля
- incomingNumber - Входящий номер
- incomingDate - Входящая дата
О работе с доп. полями Счет-фактур можно прочитать здесь
Получить полученные Счета-фактуры
Запрос всех полученных Счетов-фактур на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой полученные Счет-фактуры.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить полученные Счета-фактуры
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/facturein"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка полученных Счетов-фактур.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "facturein",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/209fe91a-ab00-11e6-8af5-581e00000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "facturein",
"mediaType": "application/json"
},
"id": "209fe91a-ab00-11e6-8af5-581e00000076",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-15 09:52:51",
"name": "00002",
"externalCode": "sylr1937hnp9AAftWLeYl3",
"moment": "2016-11-15 09:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 200000,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9596b6e2-9609-11e6-8af5-581e000000d7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/1b56b5c8-ab00-11e6-8af5-581e00000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/f4369e0b-aaff-11e6-8af5-581e0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "facturein",
"mediaType": "application/json"
},
"id": "f4369e0b-aaff-11e6-8af5-581e0000006c",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-15 09:51:37",
"name": "00001",
"externalCode": "M0YjPeX8gqISsVA32pRQu0",
"moment": "2016-11-15 09:51:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9596b6e2-9609-11e6-8af5-581e000000d7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/ecc943f6-aaff-11e6-8af5-581e00000066",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
}
]
}
Создать Счет-фактуру
Запрос на создание Счета-фактуры на основании приемки или исходящего платежа. Документ-основание должен быть указан в единственном экземпляре. Для установки incomingNumber, incomingDate значения должны быть переданы в теле Json, так как перечисленные поля не заполняются из документа-основания.
Пример создания нового Счета-фактуры, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/facturein"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"incomingNumber": "356124365",
"incomingDate": "2017-04-06 00:00:00",
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/22e8d1ea-29bc-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Счета-фактуры.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/bc060447-2b48-11e7-1542-821d00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "facturein",
"mediaType": "application/json"
},
"id": "bc060447-2b48-11e7-1542-821d00000000",
"accountId": "f4917c99-2346-11e7-1542-821d00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f500c39b-2346-11e7-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f49447eb-2346-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-04-27 17:35:04",
"name": "00001",
"description": "dsfsdf",
"externalCode": "5cp4fXAKjQ3MIxQNCKL-80",
"moment": "2017-04-27 15:55:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/f52dd97c-2346-11e7-1542-821d00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4000,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/f52d7b30-2346-11e7-1542-821d00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/f52a29b3-2346-11e7-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-04-27 15:55:04",
"incomingNumber": "356124365",
"incomingDate": "2017-04-06 00:00:00",
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/22e8d1ea-29bc-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
}
Массовое создание и обновление полученных Счетов-фактур
Массовое создание и обновление полученных Счетов-фактур. В теле запроса нужно передать массив, содержащий JSON представления полученных Счетов-фактур, которые вы хотите создать или обновить. Обновляемые полученные Счета-фактуры должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких полученных Счетов-фактур
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/facturein"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"incomingNumber": "356124365",
"incomingDate": "2017-04-06 00:00:00",
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/22e8d1ea-29bc-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/209fe91a-ab00-11e6-8af5-581e00000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "facturein",
"mediaType": "application/json"
},
"name": "FactureIn2"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных полученных Счетов-фактур.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/bc060447-2b48-11e7-1542-821d00000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "facturein",
"mediaType": "application/json"
},
"id": "bc060447-2b48-11e7-1542-821d00000000",
"accountId": "f4917c99-2346-11e7-1542-821d00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f500c39b-2346-11e7-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f49447eb-2346-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-04-27 17:35:04",
"name": "00001",
"description": "dsfsdf",
"externalCode": "5cp4fXAKjQ3MIxQNCKL-80",
"moment": "2017-04-27 15:55:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/f52dd97c-2346-11e7-1542-821d00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4000,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/f52d7b30-2346-11e7-1542-821d00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/f52a29b3-2346-11e7-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-04-27 15:55:04",
"incomingNumber": "356124365",
"incomingDate": "2017-04-06 00:00:00",
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/22e8d1ea-29bc-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/209fe91a-ab00-11e6-8af5-581e00000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "facturein",
"mediaType": "application/json"
},
"id": "209fe91a-ab00-11e6-8af5-581e00000076",
"accountId": "f4917c99-2346-11e7-1542-821d00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f500c39b-2346-11e7-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f49447eb-2346-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-04-27 18:38:19",
"name": "FactureIn2",
"description": "dsfsdf",
"externalCode": "5cp4fXAKjQ3MIxQNCKL-80",
"moment": "2017-04-27 15:55:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/f52dd97c-2346-11e7-1542-821d00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4000,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/f52d7b30-2346-11e7-1542-821d00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/f52a29b3-2346-11e7-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-04-27 15:55:04",
"incomingNumber": "356124365",
"incomingDate": "2017-04-06 00:00:00",
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/22e8d1ea-29bc-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
}
]
Метаданные полученных Счетов-фактур
Метаданные Счетов-фактур
Запрос на получение метаданных полученных Счетов-фактур. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные полученных Счетов-фактур + attributes - Массив объектов доп. полей полученных Счетов-фактур в формате Метаданных + states - Массив статусов полученных Счетов-фактур + createShared - создавать новые полученные Счета-фактуры с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные полученных Счетов-фактур
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей полученных Счетов-фактур.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata/attributes/6323a876-ab00-11e6-8af5-581e00000083",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6323a876-ab00-11e6-8af5-581e00000083",
"name": "extra field",
"type": "string",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata/attributes/6323b1d9-ab00-11e6-8af5-581e00000084",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6323b1d9-ab00-11e6-8af5-581e00000084",
"name": "else_field",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata/states/6f210951-ab00-11e6-8af5-581e00000088",
"type": "state",
"mediaType": "application/json"
},
"id": "6f210951-ab00-11e6-8af5-581e00000088",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"name": "my_status",
"color": 10066329,
"stateType": "Regular",
"entityType": "facturein"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 8b0b6c1d-aa6f-11e6-8a84-bc520000008a id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata/attributes/8b0b6c1d-aa6f-11e6-8a84-bc520000008a"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata/attributes/6323b1d9-ab00-11e6-8af5-581e00000084",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "6323b1d9-ab00-11e6-8af5-581e00000084",
"name": "else_field",
"type": "string",
"required": false
}
Шаблон полученного Счета-фактуры
Шаблон полученного Счета-фактуры на основе
Запрос на получение предзаполненного шаблона полученного Счета-фактуры на основе приемки или исходящего платежа. В ответ на запрос вернётся предзаполненный шаблон полученного Счета-фактуры, который затем можно будет использовать для создания нового Счета-фактуры с помощью POST запроса.
Пример запроса на создание шаблона полученного Счета-фактуры на основе приемки.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/facturein/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/5dfd7505-67d8-11e7-6adb-ede50000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#supply/edit?id=5dfd7505-67d8-11e7-6adb-ede50000002d"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного полученного Счета-фактуры.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/498a0445-66cc-11e7-6adb-ede50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=498a0445-66cc-11e7-6adb-ede50000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/48f21833-66cc-11e7-6adb-ede500000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2017-07-20 15:30:01",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/49b4b0b0-66cc-11e7-6adb-ede500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=49b4b0b0-66cc-11e7-6adb-ede500000058"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/49b40d55-66cc-11e7-6adb-ede500000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=49b40d55-66cc-11e7-6adb-ede500000054"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/49b00bbc-66cc-11e7-6adb-ede500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=49b00bbc-66cc-11e7-6adb-ede500000051"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata/states/7ef4eb25-6abc-11e7-6adb-ede50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "state",
"mediaType": "application/json"
}
},
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/5dfd7505-67d8-11e7-6adb-ede50000002d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#supply/edit?id=5dfd7505-67d8-11e7-6adb-ede50000002d"
}
}
]
}
Пример запроса на создание шаблона полученного Счета-фактуры на основе исходящего платежа.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/facturein/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"payments": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/dc5acb9c-6d46-11e7-6adb-ede500000030",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#paymentout/edit?id=dc5acb9c-6d46-11e7-6adb-ede500000030"
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного полученного Счета-фактуры.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/498a0445-66cc-11e7-6adb-ede50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#employee/edit?id=498a0445-66cc-11e7-6adb-ede50000002a"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/48f21833-66cc-11e7-6adb-ede500000001",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2017-07-20 15:29:19",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/49b4b0b0-66cc-11e7-6adb-ede500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#currency/edit?id=49b4b0b0-66cc-11e7-6adb-ede500000058"
}
}
},
"sum": 0,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/d77f0d20-6ae2-11e7-6adb-ede50000001c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=d77f0d20-6ae2-11e7-6adb-ede50000001c"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/49b00bbc-66cc-11e7-6adb-ede500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#mycompany/edit?id=49b00bbc-66cc-11e7-6adb-ede500000051"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata/states/7ef4eb25-6abc-11e7-6adb-ede50000000a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "state",
"mediaType": "application/json"
}
},
"payments": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/dc5acb9c-6d46-11e7-6adb-ede500000030",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentout/metadata",
"type": "paymentout",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#paymentout/edit?id=dc5acb9c-6d46-11e7-6adb-ede500000030"
}
}
]
}
Счет-фактура полученный
Получить полученный Счет-фактуру
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счета-фактуры. |
Запрос на получение отдельного полученного Счета-фактуры с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/facturein/209fe91a-ab00-11e6-8af5-581e00000076"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление полученного Счета-фактуры.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/209fe91a-ab00-11e6-8af5-581e00000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "facturein",
"mediaType": "application/json"
},
"id": "209fe91a-ab00-11e6-8af5-581e00000076",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-15 09:52:51",
"name": "00002",
"externalCode": "sylr1937hnp9AAftWLeYl3",
"moment": "2016-11-15 09:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 200000,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/9596b6e2-9609-11e6-8af5-581e000000d7",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/1b56b5c8-ab00-11e6-8af5-581e00000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
}
Изменить полученный Счет-фактуру
Запрос на обновление Счета-фактуры с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счета-фактуры. |
Пример запроса на обновление Счета-фактуры.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/facturein/209fe91a-ab00-11e6-8af5-581e00000076"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "FactureIn2"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Счета-фактуры.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/209fe91a-ab00-11e6-8af5-581e00000076",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/facturein/metadata",
"type": "facturein",
"mediaType": "application/json"
},
"id": "209fe91a-ab00-11e6-8af5-581e00000076",
"accountId": "f4917c99-2346-11e7-1542-821d00000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/f500c39b-2346-11e7-1542-821d0000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f49447eb-2346-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2017-04-27 18:38:19",
"name": "FactureIn2",
"description": "dsfsdf",
"externalCode": "5cp4fXAKjQ3MIxQNCKL-80",
"moment": "2017-04-27 15:55:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/f52dd97c-2346-11e7-1542-821d00000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 4000,
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/f52d7b30-2346-11e7-1542-821d00000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/f52a29b3-2346-11e7-1542-821d00000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2017-04-27 15:55:04",
"incomingNumber": "356124365",
"incomingDate": "2017-04-06 00:00:00",
"supplies": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/supply/22e8d1ea-29bc-11e7-1542-821d00000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/supply/metadata",
"type": "supply",
"mediaType": "application/json"
}
}
]
}
Удалить полученный Счет-фактуру
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Счета-фактуры. |
Запрос на удаление полученного Счета-фактуры с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/facturein/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление полученного Счета-фактуры.
Документ Инвентаризация
Средствами JSON API можно создавать и обновлять сведения о Инвентаризации, запрашивать списки Инвентаризаций и сведения по отдельным Инвентаризациям. Позициями Инвентаризации можно управлять как в составе отдельной Инвентаризации, так и отдельно - с помощью специальных ресурсов для управления позициями Инвентаризации. Кодом сущности для Инвентаризации в составе JSON API является ключевое слово inventory. Больше о Инвентаризациях можно прочитать этой ссылке.
Инвентаризация
Атрибуты сущности
- meta - Метаданные о Инвентаризации
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Инвентаризации
- externalCode - Внешний код Инвентаризации
- moment - Дата Инвентаризации
- sum - Сумма Инвентаризации в копейках
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
Необходимое - state - Статус Инвентаризации в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - positions - Ссылка на позиции Инвентаризации в формате Метаданных
Позиции Инвентаризации
Позиции Инвентаризации - это список товаров/модификаций/серий.
Объект позиции Инвентаризации содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Фактическое количество товаров/модификаций/серий.
+ price - Цена товара в копейках
+ assortment - Ссылка на товар/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ correctionAmount - разница между расчетным остатком и фактическим Только для чтения
+ calculatedQuantity - расчетный остаток
+ correctionSum - избыток/недостача Только для чтения
С позициями можно работать с помощью специальных ресурсов для управления позициями Инвентаризации, а также в составе отдельной Инвентаризации. При работе в составе отдельной Инвентаризации, вы можете отправлять запросы на создание отдельной Инвентаризации с включенным в тело запроса массивом позиций Инвентаризации. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Инвентаризации". Также, при работе в составе отдельной Инвентаризации, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Инвентаризации. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Инвентаризации" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями Инвентаризации можно прочитать здесь
Получить Инвентаризации
Запрос всех Инвентаризаций на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Инвентаризации.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить Инвентаризации
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/inventory"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Инвентаризаций.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/7ee45d2d-ad65-11e6-8a84-bc52000000db",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json"
},
"id": "7ee45d2d-ad65-11e6-8a84-bc52000000db",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 11:03:31",
"name": "00001",
"externalCode": "HCUtF6T2jnNOzNbh-ZNNo1",
"moment": "2016-11-18 11:03:00",
"sum": 480000,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/7ee45d2d-ad65-11e6-8a84-bc52000000db/positions",
"type": "inventoryposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/8c3e615a-ad65-11e6-8a84-bc52000000df",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json"
},
"id": "8c3e615a-ad65-11e6-8a84-bc52000000df",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 11:03:53",
"name": "00002",
"externalCode": "aNpAW66rhIjZ4VmhA4igz0",
"moment": "2016-11-18 11:03:00",
"sum": 1020000,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/8c3e615a-ad65-11e6-8a84-bc52000000df/positions",
"type": "inventoryposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
]
}
Создать Инвентаризацию
Запрос на создание новой Инвентаризации
Пример создания новой Инвентаризации с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/inventory"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Инвентаризации.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/8a2a5d07-ad6d-11e6-8a84-bc520000000a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json"
},
"id": "8a2a5d07-ad6d-11e6-8a84-bc520000000a",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 12:01:06",
"name": "00005",
"externalCode": "n0vO68WUgOh9OcHApWSVc2",
"moment": "2016-11-18 12:01:06",
"sum": 0,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/8a2a5d07-ad6d-11e6-8a84-bc520000000a/positions",
"type": "inventoryposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
}
Массовое создание и обновление Инвентаризаций
Массовое создание и обновление Инвентаризаций. В теле запроса нужно передать массив, содержащий JSON представления Инвентаризаций, которые вы хотите создать или обновить. Обновляемые Инвентаризации должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Инвентаризаций
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/inventory"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json"
},
"name": "newname",
"positions": {
"rows": [
{
"quantity": 140,
"price": 5000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/b6be720e-ad63-11e6-8a84-bc520000008f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"correctionAmount": -60,
"calculatedQuantity": 200,
"correctionSum": -300000
},
{
"quantity": 80,
"price": 4000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/58948866-ad65-11e6-8a84-bc52000000cf",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"correctionAmount": -20,
"calculatedQuantity": 100,
"correctionSum": -80000
}
]
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Инвентаризаций.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/8a2a5d07-ad6d-11e6-8a84-bc520000000a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json"
},
"id": "8a2a5d07-ad6d-11e6-8a84-bc520000000a",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 12:01:06",
"name": "00005",
"externalCode": "n0vO68WUgOh9OcHApWSVc2",
"moment": "2016-11-18 12:01:06",
"sum": 0,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/8a2a5d07-ad6d-11e6-8a84-bc520000000a/positions",
"type": "inventoryposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json"
},
"id": "57a0bbfb-ad6d-11e6-8a84-bc52000000e7",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 12:12:27",
"name": "newname",
"externalCode": "6iP5E4LLhpzxRKezcuKE90",
"moment": "2016-11-18 11:59:00",
"sum": 1020000,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions",
"type": "inventoryposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
]
Удалить Инвентаризацию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Инвентаризации. |
Запрос на удаление Инвентаризации с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Инвентаризации.
Метаданные Инвентаризаций
Метаданные Инвентаризаций
Запрос на получение метаданных Инвентаризаций. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Инвентаризаций + attributes - Массив объектов доп. полей Инвентаризаций в формате Метаданных + states - Массив статусов Инвентаризаций + createShared - создавать новые Инвентаризации с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Инвентаризаций
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных Инвентаризаций.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata/attributes/1f7dbb1b-ad6e-11e6-8a84-bc52000000eb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "1f7dbb1b-ad6e-11e6-8a84-bc52000000eb",
"name": "доп.поле1",
"type": "string",
"required": false
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata/attributes/1f7dc230-ad6e-11e6-8a84-bc52000000ec",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "1f7dc230-ad6e-11e6-8a84-bc52000000ec",
"name": "доп.поле2",
"type": "long",
"required": false
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata/attributes/1f7dbb1b-ad6e-11e6-8a84-bc52000000eb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "1f7dbb1b-ad6e-11e6-8a84-bc52000000eb",
"name": "доп.поле1",
"type": "string",
"required": false
}
Шаблон инвентаризации
Шаблон инвентаризации
Запрос на получение предзаполненого стандартными значениями шаблона инвентаризации без связи с каким-либо документом.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного списания.
{
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 17:52:33",
"sum": 0,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"rows": []
}
}
Инвентаризация
Получить Инвентаризацию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Инвентаризации. |
Запрос на получение отдельной инвентаризации с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Инвентаризации.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json"
},
"id": "57a0bbfb-ad6d-11e6-8a84-bc52000000e7",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 11:59:41",
"name": "00004",
"externalCode": "6iP5E4LLhpzxRKezcuKE90",
"moment": "2016-11-18 11:59:00",
"sum": 0,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions",
"type": "inventoryposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
}
Изменить Инвентаризацию
Запрос на обновление инвентаризации с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Инвентаризации. |
Пример запроса на обновление отдельной Инвентаризации.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "newname",
"positions": {
"rows": [
{
"quantity": 140,
"price": 5000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/b6be720e-ad63-11e6-8a84-bc520000008f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"correctionAmount": -60,
"calculatedQuantity": 200,
"correctionSum": -300000
},
{
"quantity": 80,
"price": 4000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/58948866-ad65-11e6-8a84-bc52000000cf",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"correctionAmount": -20,
"calculatedQuantity": 100,
"correctionSum": -80000
}
]
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Инвентаризации.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json"
},
"id": "57a0bbfb-ad6d-11e6-8a84-bc52000000e7",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 12:12:27",
"name": "newname",
"externalCode": "6iP5E4LLhpzxRKezcuKE90",
"moment": "2016-11-18 11:59:00",
"sum": 1020000,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions",
"type": "inventoryposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Пример запроса на изменение Инвентаризации с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata/attributes/1f7dbb1b-ad6e-11e6-8a84-bc52000000eb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "1f7dbb1b-ad6e-11e6-8a84-bc52000000eb",
"name": "доп.поле1",
"type": "string",
"value": "text"
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata/attributes/1f7dc230-ad6e-11e6-8a84-bc52000000ec",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "1f7dc230-ad6e-11e6-8a84-bc52000000ec",
"name": "доп.поле2",
"type": "long",
"value": 42
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой Инвентаризации.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata",
"type": "inventory",
"mediaType": "application/json"
},
"id": "57a0bbfb-ad6d-11e6-8a84-bc52000000e7",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/c4b17cf2-99bb-11e6-8a84-bc520000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/c3cff163-99bb-11e6-8a84-bc5200000002",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 12:12:27",
"name": "newname",
"externalCode": "6iP5E4LLhpzxRKezcuKE90",
"moment": "2016-11-18 11:59:00",
"sum": 1020000,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c4eddfc8-99bb-11e6-8a84-bc5200000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/c4dee133-99bb-11e6-8a84-bc5200000051",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata/attributes/1f7dbb1b-ad6e-11e6-8a84-bc52000000eb",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "1f7dbb1b-ad6e-11e6-8a84-bc52000000eb",
"name": "доп.поле1",
"type": "string",
"value": "text"
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/metadata/attributes/1f7dc230-ad6e-11e6-8a84-bc52000000ec",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "1f7dc230-ad6e-11e6-8a84-bc52000000ec",
"name": "доп.поле2",
"type": "long",
"value": 42
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions",
"type": "inventoryposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Позиции Инвентаризации
Отдельный ресурс для управления позициями Инвентаризации. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Инвентаризации
Запрос на получение списка всех позиций данной Инвентаризации. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Инвентаризации.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Инвентаризации. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Инвентаризации
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельной Инвентаризации.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions",
"type": "inventoryposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions/201452a2-ad6f-11e6-8a84-bc5200000010",
"type": "inventoryposition",
"mediaType": "application/json"
},
"id": "201452a2-ad6f-11e6-8a84-bc5200000010",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"quantity": 140,
"price": 5000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/b6be720e-ad63-11e6-8a84-bc520000008f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"correctionAmount": -60,
"calculatedQuantity": 200,
"correctionSum": -300000
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions/20145d98-ad6f-11e6-8a84-bc5200000011",
"type": "inventoryposition",
"mediaType": "application/json"
},
"id": "20145d98-ad6f-11e6-8a84-bc5200000011",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"quantity": 80,
"price": 4000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/58948866-ad65-11e6-8a84-bc52000000cf",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"correctionAmount": -20,
"calculatedQuantity": 100,
"correctionSum": -80000
}
]
}
Создать позицию Инвентаризации
Запрос на создание новой позиции в Инвентаризации. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции Инвентаризации + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций Инвентаризации. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Инвентаризации. |
Пример создания позиций в Инвентаризации.
shell curl -X POST "https://online.moysklad.ru/api/remap/1.2/entity/inventory/7944ef04-f831-11e5-7a69-971500188b19/positions" -H "Authorization: Basic <Access-Token>" -H "Content-Type: application/json" -d '{ "meta": { "href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions/201452a2-ad6f-11e6-8a84-bc5200000010", "type": "inventoryposition", "mediaType": "application/json" }, "id": "201452a2-ad6f-11e6-8a84-bc5200000010", "accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001", "quantity": 140, "price": 2000, "assortment": { "meta": { "href": "http://online.moysklad.ru/api/remap/1.2/entity/product/b6be720e-ad63-11e6-8a84-bc520000008f", "metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata", "type": "product", "mediaType": "application/json" } } }'Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельной Инвентаризации.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions/201452a2-ad6f-11e6-8a84-bc5200000010",
"type": "inventoryposition",
"mediaType": "application/json"
},
"id": "201452a2-ad6f-11e6-8a84-bc5200000010",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"quantity": 140,
"price": 2000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/b6be720e-ad63-11e6-8a84-bc520000008f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"correctionAmount": -60,
"calculatedQuantity": 200,
"correctionSum": -120000
}
]
Позиция Инвентаризации
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Инвентаризации. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции. |
Запрос на получение отдельной позиции Инвентаризации с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Инвентаризации.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions/201452a2-ad6f-11e6-8a84-bc5200000010",
"type": "inventoryposition",
"mediaType": "application/json"
},
"id": "201452a2-ad6f-11e6-8a84-bc5200000010",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"quantity": 140,
"price": 5000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/b6be720e-ad63-11e6-8a84-bc520000008f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"correctionAmount": -60,
"calculatedQuantity": 200,
"correctionSum": -300000
}
Изменить позицию
Запрос на обновление отдельной позиции Инвентаризации. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Инвентаризации. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции. |
Пример запроса на обновление отдельной позиции в Инвентаризации.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions/201452a2-ad6f-11e6-8a84-bc5200000010",
"type": "inventoryposition",
"mediaType": "application/json"
},
"id": "201452a2-ad6f-11e6-8a84-bc5200000010",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"quantity": 45,
"price": 1000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/b6be720e-ad63-11e6-8a84-bc520000008f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Инвентаризации.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/inventory/57a0bbfb-ad6d-11e6-8a84-bc52000000e7/positions/201452a2-ad6f-11e6-8a84-bc5200000010",
"type": "inventoryposition",
"mediaType": "application/json"
},
"id": "201452a2-ad6f-11e6-8a84-bc5200000010",
"accountId": "c3cc7e30-99bb-11e6-8a84-bc5200000001",
"quantity": 45,
"price": 1000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/b6be720e-ad63-11e6-8a84-bc520000008f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"correctionAmount": -155,
"calculatedQuantity": 200,
"correctionSum": -155000
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Инвентаризации. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции. |
Запрос на удаление отдельной позиции Инвентаризации с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/inventory/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Инвентаризации.
Полученный отчёт комиссионера
Средствами JSON API можно создавать и обновлять сведения о полученных отчётах комиссионера, запрашивать списки полученных отчётов комиссионера и сведения по отдельным полученным отчётам комиссионера. Позициями отчётов комиссионера можно управлять как в составе отдельного отчёта, так и с помощью специальных ресурсов для управления позициями. Кодом сущности для полученного отчёта комиссионера в составе JSON API является ключевое слово commissionreportin. Больше об отчётах комиссионера и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Полученные отчёты комиссионера
Атрибуты сущности
- meta - Метаданные о полученном отчёте комиссионера
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер полученного отчёта комиссионера
Необходимое - description - Комментарий полученного отчёта комиссионера
- externalCode - Внешний код полученного отчёта комиссионера
- moment - Дата полученного отчёта комиссионера
- applicable - Отметка о проведении
- sum - Сумма полученного отчёта комиссионера в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
Необходимое - project - Ссылка на проект в формате Метаданных
- state - Статус полученного отчёта комиссионера в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения - payedSum - Оплаченная сумма
Только для чтения - vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- positions - Ссылка на позиции полученного отчёта комиссионера в формате Метаданных
- commissionPeriodStart - Начало периода
Необходимое - commissionPeriodEnd - Конец периода
Необходимое - rewardType - Тип вознаграждения
- rewardPercent - Процент вознаграждения (всегда 0 если вознаграждение не рассчитывается)
- commitentSum - Сумма коммитента в установленной валюте
Только для чтения#### Связи с другими документами - payments - Массив ссылок на связанные платежи в формате Метаданных
Позиции полученного отчёта комиссионера
Позиции полученного отчёта комиссионера - это список товаров/услуг/модификаций/серий.
Объект позиции полученного отчёта комиссионера содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ reward - Вознаграждение
С позициями можно работать с помощью специальных ресурсов для управления позициями полученного отчёта комиссионера, а также в составе отдельного полученного отчёта комиссионера. При работе в составе отдельного полученного отчёта комиссионера, вы можете отправлять запросы на создание полученного отчёта комиссионера с включенным в тело запроса массивом позиций полученного отчёта комиссионера. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции отчёта комиссионера". Также, при работе в составе отдельного полученного отчёта комиссионера, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций полученного отчёта комиссионера. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции полученного отчёта комиссионера" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
Получить отчёты комиссионера
Запрос всех полученных отчётов комиссионера на учётной записи.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
| incomingDate | string (optional) Example: 2016-04-15 15:48:46 Параметр для фильтрации выборки по входящей дате. Подробнее про данный параметр можно посмотреть в разделе Фильтрация выборки с помощью параметра filter. Формат строки : ГГГГ-ММ-ДД ЧЧ:ММ:СС[.ммм], Часовой пояс: MSK (Московское время) |
Получить отчёты комиссионера
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка полученных отчётов комиссионера.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"id": "392fb7a9-ab02-11e6-8a84-bae500000073",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-15 10:11:35",
"name": "00001",
"externalCode": "DfZi0N0mggqmVRt2hVf8t2",
"moment": "2016-11-15 10:04:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073/positions",
"type": "commissionreportinposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-09 10:07:00",
"commissionPeriodEnd": "2016-11-09 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 0,
"commitentSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/6348c14c-ab39-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"id": "6348c14c-ab39-11e6-8a84-bae500000064",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 17:10:23",
"name": "00002",
"externalCode": "ec21rBixjdrEm0CVkCiOJ0",
"moment": "2016-11-15 14:19:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/6348c14c-ab39-11e6-8a84-bae500000064/positions",
"type": "commissionreportinposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-15 14:19:00",
"commissionPeriodEnd": "2016-11-15 14:22:00",
"rewardType": "None",
"rewardPercent": 0,
"commitentSum": 0,
"payments": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/e39851ec-ab43-11e6-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
]
}
Создать полученный отчёт комиссионера
Запрос на создание нового полученного отчёта комиссионера. Обязательные для создания поля: + name - номер + agent - контрагент + contract - договор + organization - юрлицо + commissionPeriodStart - начало периода + commissionPeriodEnd - конец периода + organizationAccount - счёт юрлица (если у юрлица несколько счетов) + agentAccount - счёт контрагента (если у контрагента несколько счетов)
При указании поля contract важно: + Чтобы договор был заключён с указанным в поле agent контрагентом + Договор имел тип "Договор комиссии"
Пример создания нового полученного отчёта комиссионера.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36eb1628-912b-11e6-8a84-bae500000124",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 2,
"price": 132.05,
"vat": 10,
"reward": 123
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 15,
"price": 99.99,
"vat": 0,
"reward": 100
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"value": "value"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"value": "values"
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-11-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 15
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного полученного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"id": "cc5beac8-acdb-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 18:37:50",
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1764,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"value": "value"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"value": "values"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000/positions",
"type": "commissionreportinposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 24,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-11-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 15,
"commitentSum": 1499
}
Массовое создание и обновление полученных отчётов комиссионера
Массовое создание и обновление полученных отчётов комиссионера. В теле запроса нужно передать массив, содержащий JSON представления полученных отчётов комиссионера, которые вы хотите создать или обновить. Обновляемые полученные отчёты комиссионера должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких полученных отчётов комиссионера
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36eb1628-912b-11e6-8a84-bae500000124",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 2,
"price": 132.05,
"vat": 10,
"reward": 123
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 15,
"price": 99.99,
"vat": 0,
"reward": 100
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"value": "value"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"value": "values"
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-11-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 15
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36eb1628-912b-11e6-8a84-bae500000124",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 12,
"price": 132.05,
"vat": 10,
"reward": 123
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 15,
"price": 99.399,
"vat": 0,
"reward": 100
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"value": "Newvalue"
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-12-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 12
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных полученных отчётов комиссионера.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"id": "cc5beac8-acdb-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 18:37:50",
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1764,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"value": "value"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"value": "values"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000/positions",
"type": "commissionreportinposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 24,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-11-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 15,
"commitentSum": 1499
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"id": "cc5beac8-acdb-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 20:11:40",
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 3069,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/states/40ca02eb-acda-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"value": "Newvalue"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"value": "values"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000/positions",
"type": "commissionreportinposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 144,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-12-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 12,
"commitentSum": 2701
}
]
Удалить полученный отчёт комиссионера
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id полученного отчёта комиссионера. |
Запрос на удаление полученного отчёта комиссионера с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление полученного отчёта комиссионера.
Метаданные полученного отчёта
Метаданные полученного отчёта
Запрос на получение метаданных отчётов комиссионера. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные отчётов комиссионера + attributes - Массив объектов доп. полей отчётов комиссионера в формате Метаданных + states - Массив статусов отчётов комиссионера + createShared - создавать новые отчёты комиссионера с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные полученного отчёта
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных полученного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/states/40ca02eb-acda-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "40ca02eb-acda-11e6-8a84-bae500000069",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"name": "Статус",
"color": 10066329,
"stateType": "Regular",
"entityType": "commissionreportin"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"required": false
}
Полученный отчёт комиссионера
Получить отчёт комиссионера
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id полученного отчёта комиссионера. |
Запрос на получение отдельного отчёта комиссионера с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление полученного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"id": "392fb7a9-ab02-11e6-8a84-bae500000073",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-15 10:11:35",
"name": "00001",
"externalCode": "DfZi0N0mggqmVRt2hVf8t2",
"moment": "2016-11-15 10:04:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/392fb7a9-ab02-11e6-8a84-bae500000073/positions",
"type": "commissionreportinposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-09 10:07:00",
"commissionPeriodEnd": "2016-11-09 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 0,
"commitentSum": 0
}
Изменить полученный отчёт комиссионера
Запрос на обновление полученного отчёта комиссионера с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у полученного отчёта комиссионера, кроме тех, что
помечены Только для чтения в описании атрибутов полученного отчёта комиссионера.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
При указании поля contract важно:
+ Чтобы договор был заключён с указанным в поле agent контрагентом
+ Договор имел тип "Договор комиссии"
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id полученного отчёта комиссионера. |
Пример запроса на обновление отдельного отчёта комиссионера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36eb1628-912b-11e6-8a84-bae500000124",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 12,
"price": 132.05,
"vat": 10,
"reward": 123
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 15,
"price": 99.399,
"vat": 0,
"reward": 100
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"value": "Newvalue"
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-12-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 12
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata",
"type": "commissionreportin",
"mediaType": "application/json"
},
"id": "cc5beac8-acdb-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 20:11:40",
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 3069,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/states/40ca02eb-acda-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"value": "Newvalue"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"value": "values"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000/positions",
"type": "commissionreportinposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 144,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-12-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 12,
"commitentSum": 2701
}
Позиции отчёта комиссионера
Отдельный ресурс для управления позициями полученного отчёта комиссионера. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции
Запрос на получение списка всех позиций данного полученного отчёта комиссионера.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id полученного отчёта комиссионера. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного отчёта комиссионера.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/6348c14c-ab39-11e6-8a84-bae500000064/positions",
"type": "commissionreportinposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/6348c14c-ab39-11e6-8a84-bae500000064/positions/94aef79a-accf-11e6-8a84-bae500000064",
"type": "commissionreportinposition",
"mediaType": "application/json"
},
"id": "94aef79a-accf-11e6-8a84-bae500000064",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/ca976541-96d1-11e6-8a84-bae50000002e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reward": 0
}
]
}
Создать позицию
Запрос на создание новой позиции в отчёте комиссионера. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции отчёта комиссионера + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций отчёта комиссионера. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id полученного отчёта комиссионера. |
Пример создания одной позиции в полученном отчёте комиссионера.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 15,
"price": 1300,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 225
},
{
"quantity": 15,
"price": 1020,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 225
},
{
"quantity": 15,
"price": 101,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 225
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного отчёта комиссионера.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000/positions/a7a61c8b-acdd-11e6-8a84-bae500000000",
"type": "commissionreportinposition",
"mediaType": "application/json"
},
"id": "a7a61c8b-acdd-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 15,
"price": 1300,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 2925
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000/positions/a7a6c749-acdd-11e6-8a84-bae500000001",
"type": "commissionreportinposition",
"mediaType": "application/json"
},
"id": "a7a6c749-acdd-11e6-8a84-bae500000001",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 15,
"price": 1020,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 2295
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000/positions/a7a6d9cc-acdd-11e6-8a84-bae500000002",
"type": "commissionreportinposition",
"mediaType": "application/json"
},
"id": "a7a6d9cc-acdd-11e6-8a84-bae500000002",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 15,
"price": 101,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 227
}
]
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id полученного отчёта комиссионера. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции полученного отчёта комиссионера. |
Запрос на удаление позиции полученного отчёта комиссионера с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции полученного отчёта комиссионера.
Позиция отчёта комиссионера
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id полученного отчёта комиссионера. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции полученного отчёта комиссионера. |
Запрос на получение отдельной позиции полученного отчёта комиссионера с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции полученного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/6348c14c-ab39-11e6-8a84-bae500000064/positions/94aef79a-accf-11e6-8a84-bae500000064",
"type": "commissionreportinposition",
"mediaType": "application/json"
},
"id": "94aef79a-accf-11e6-8a84-bae500000064",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/ca976541-96d1-11e6-8a84-bae50000002e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reward": 0
}
Изменить позицию
Запрос на обновление отдельной позиции полученного отчёта комиссионера. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id полученного отчёта комиссионера. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции полученного отчёта комиссионера. |
Пример запроса на обновление отдельной позиции в полученном отчёте комиссионера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 14,
"price": 1301,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 0
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции полученного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportin/cc5beac8-acdb-11e6-8a84-bae500000000/positions/a7a6c749-acdd-11e6-8a84-bae500000001",
"type": "commissionreportinposition",
"mediaType": "application/json"
},
"id": "a7a6c749-acdd-11e6-8a84-bae500000001",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 14,
"price": 1301,
"vat":**Параметры**
|Параметр |Описание |
|---|---|
|id | `string` (required) *Example: 7944ef04-f831-11e5-7a69-971500188b19* id полученного отчёта комиссионера.|
|positionID| `string` (required) *Example: 7944ef04-f831-11e5-7a69-971500188b19* id позиции полученного отчёта комиссионера.|
10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 0
}
Выданный отчёт комиссионера
Средствами JSON API можно создавать и обновлять сведения о выданных отчётах комиссионера, запрашивать списки выданных отчётов комиссионера и сведения по отдельным выданным отчётам комиссионера. Позициями отчётов комиссионера можно управлять как в составе отдельного отчёта, так и с помощью специальных ресурсов для управления позициями. Кодом сущности для выданного отчёта комиссионера в составе JSON API является ключевое слово commissionreportout. Больше об отчётах комиссионера и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Выданные отчёты комиссионера
Атрибуты сущности
- meta - Метаданные о выданном отчёте комиссионера
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер выданного отчёта комиссионера
Необходимое - description - Комментарий выданного отчёта комиссионера
- externalCode - Внешний код выданного отчёта комиссионера
- moment - Дата выданного отчёта комиссионера
- applicable - Отметка о проведении
- sum - Сумма выданного отчёта комиссионера в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - agent - Ссылка на контрагента в формате Метаданных
Необходимое - contract - Ссылка на договор в формате Метаданных
Необходимое - project - Ссылка на проект в формате Метаданных
- state - Статус выданного отчёта комиссионера в формате Метаданных
- organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- agentAccount - Ссылка на счёт контрагента в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - vatSum - Сумма НДС
Только для чтения - payedSum - Оплаченная сумма
Только для чтения - vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- positions - Ссылка на позиции выданного отчёта комиссионера в формате Метаданных
- commissionPeriodStart - Начало периода
Необходимое - commissionPeriodEnd - Конец периода
Необходимое - rewardType - Тип вознаграждения
- rewardPercent - Процент вознаграждения (всегда 0 если вознаграждение не рассчитывается)
- commitentSum - Сумма коммитента в установленной валюте
Только для чтения
Связи с другими документами
- payments - Массив ссылок на связанные платежи в формате Метаданных
Позиции выданного отчёта комиссионера
Позиции выданного отчёта комиссионера - это список товаров/услуг/модификаций/серий.
Объект позиции выданного отчёта комиссионера содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/услуг данного вида в позиции. Если позиция - товар, у которого включен учёт по серийным номерам, то значение в этом поле всегда будет равно количеству серийных номеров для данной позиции в документе.
+ price - Цена товара/услуги в копейках
+ vat - НДС, которым облагается текущая позиция
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ reward - Вознаграждение
С позициями можно работать с помощью специальных ресурсов для управления позициями выданного отчёта комиссионера, а также в составе отдельного выданного отчёта комиссионера. При работе в составе отдельного выданного отчёта комиссионера, вы можете отправлять запросы на создание выданного отчёта комиссионера с включенным в тело запроса массивом позиций выданного отчёта комиссионера. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции отчёта комиссионера". Также, при работе в составе отдельного выданного отчёта комиссионера, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций выданного отчёта комиссионера. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции выданного отчёта комиссионера" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
Получить выданные отчёты комиссионера
Запрос всех выданных отчётов комиссионера на учётной записи.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить выданные отчёты комиссионера
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка выданных отчётов комиссионера.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/392fb7a9-ab02-11e6-8a84-bae500000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"id": "392fb7a9-ab02-11e6-8a84-bae500000073",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-15 10:11:35",
"name": "00001",
"externalCode": "DfZi0N0mggqmVRt2hVf8t2",
"moment": "2016-11-15 10:04:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/392fb7a9-ab02-11e6-8a84-bae500000073/positions",
"type": "commissionreportoutposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-09 10:07:00",
"commissionPeriodEnd": "2016-11-09 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 0,
"commitentSum": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/6348c14c-ab39-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"id": "6348c14c-ab39-11e6-8a84-bae500000064",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 17:10:23",
"name": "00002",
"externalCode": "ec21rBixjdrEm0CVkCiOJ0",
"moment": "2016-11-15 14:19:00",
"applicable": true,
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/6348c14c-ab39-11e6-8a84-bae500000064/positions",
"type": "commissionreportoutposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-15 14:19:00",
"commissionPeriodEnd": "2016-11-15 14:22:00",
"rewardType": "None",
"rewardPercent": 0,
"commitentSum": 0,
"payments": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/e39851ec-ab43-11e6-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/paymentin/metadata",
"type": "paymentin",
"mediaType": "application/json"
},
"linkedSum": 0
}
]
}
]
}
Создать выданный отчёт комиссионера
Запрос на создание нового выданного отчёта комиссионера. Обязательные для создания поля: + name - номер + agent - контрагент + contract - договор + organization - юрлицо + commissionPeriodStart - начало периода + commissionPeriodEnd - конец периода + organizationAccount - счёт юрлица (если у юрлица несколько счетов) + agentAccount - счёт контрагента (если у контрагента несколько счетов)
При указании поля contract важно: + Чтобы договор был заключён с указанным в поле agent контрагентом + Договор имел тип "Договор комиссии"
Пример создания нового выданного отчёта комиссионера.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36eb1628-912b-11e6-8a84-bae500000124",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 2,
"price": 132.05,
"vat": 10,
"reward": 123
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 15,
"price": 99.99,
"vat": 0,
"reward": 100
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"value": "value"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"value": "values"
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-11-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 15
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного выданного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"id": "cc5beac8-acdb-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 18:37:50",
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1764,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"value": "value"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"value": "values"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000/positions",
"type": "commissionreportoutposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 24,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-11-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 15,
"commitentSum": 1499
}
Удалить выданный отчёт комиссионера
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id выданного отчёта комиссионера. |
Запрос на удаление выданного отчёта комиссионера с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление выданного отчёта комиссионера.
Массовое создание и обновление выданных отчётов комиссионера
Массовое создание и обновление выданных отчётов комиссионера. В теле запроса нужно передать массив, содержащий JSON представления выданных отчётов комиссионера, которые вы хотите создать или обновить. Обновляемые выданные отчёты комиссионера должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких выданных отчётов комиссионера
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36eb1628-912b-11e6-8a84-bae500000124",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 2,
"price": 132.05,
"vat": 10,
"reward": 123
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 15,
"price": 99.99,
"vat": 0,
"reward": 100
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"value": "value"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"value": "values"
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-11-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 15
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36eb1628-912b-11e6-8a84-bae500000124",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 12,
"price": 132.05,
"vat": 10,
"reward": 123
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 15,
"price": 99.399,
"vat": 0,
"reward": 100
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"value": "Newvalue"
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-12-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 12
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных выданных отчётов комиссионера.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"id": "cc5beac8-acdb-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 18:37:50",
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 1764,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"value": "value"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"value": "values"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000/positions",
"type": "commissionreportoutposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 24,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-11-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 15,
"commitentSum": 1499
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"id": "cc5beac8-acdb-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 20:11:40",
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 3069,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/states/40ca02eb-acda-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"value": "Newvalue"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"value": "values"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000/positions",
"type": "commissionreportoutposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 144,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-12-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 12,
"commitentSum": 2701
}
]
Метаданные выданного отчёта
Метаданные выданного отчёта
Запрос на получение метаданных отчётов комиссионера. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные отчётов комиссионера + attributes - Массив объектов доп. полей отчётов комиссионера в формате Метаданных + states - Массив статусов отчётов комиссионера + createShared - создавать новые отчёты комиссионера с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные выданного отчёта
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных выданного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"required": false
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/states/40ca02eb-acda-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "40ca02eb-acda-11e6-8a84-bae500000069",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"name": "Статус",
"color": 10066329,
"stateType": "Regular",
"entityType": "commissionreportout"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"required": false
}
Выданный отчёт комиссионера
Получить выданный отчёт комиссионера
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id выданного отчёта комиссионера. |
Запрос на получение отдельного отчёта комиссионера с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление выданного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/392fb7a9-ab02-11e6-8a84-bae500000073",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"id": "392fb7a9-ab02-11e6-8a84-bae500000073",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-15 10:11:35",
"name": "00001",
"externalCode": "DfZi0N0mggqmVRt2hVf8t2",
"moment": "2016-11-15 10:04:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/392fb7a9-ab02-11e6-8a84-bae500000073/positions",
"type": "commissionreportoutposition",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-09 10:07:00",
"commissionPeriodEnd": "2016-11-09 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 0,
"commitentSum": 0
}
Изменить выданный отчёт комиссионера
Запрос на обновление выданного отчёта комиссионера с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у выданного отчёта комиссионера, кроме тех, что
помечены Только для чтения в описании атрибутов выданного отчёта комиссионера.
При обновлении полей organization и agent нужно также обновить поля organizationAccount и
agentAccount соответственно, иначе произойдёт ошибка.
При указании поля contract важно:
+ Чтобы договор был заключён с указанным в поле agent контрагентом
+ Договор имел тип "Договор комиссии"
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id выданного отчёта комиссионера. |
Пример запроса на обновление отдельного отчёта комиссионера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/7944ef04-f831-11e5-7a69-971500188b19
"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"sum": 0,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"positions": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36eb1628-912b-11e6-8a84-bae500000124",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 12,
"price": 132.05,
"vat": 10,
"reward": 123
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"quantity": 15,
"price": 99.399,
"vat": 0,
"reward": 100
}
],
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"value": "Newvalue"
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-12-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 12
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata",
"type": "commissionreportout",
"mediaType": "application/json"
},
"id": "cc5beac8-acdb-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 20:11:40",
"name": "3335551",
"externalCode": "extCod1",
"moment": "2016-12-16 11:22:33",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 3069,
"contract": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/contract/92df2d9c-ab02-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/contract/metadata",
"type": "contract",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"agent": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b942c396-9128-11e6-8a84-bae500000056",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051/accounts/b932bc5b-9128-11e6-8a84-bae500000052",
"type": "account",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/states/40ca02eb-acda-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a123-acda-11e6-8a84-bae50000006d",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a123-acda-11e6-8a84-bae50000006d",
"name": "Поле1",
"type": "string",
"value": "Newvalue"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/metadata/attributes/4930a9c5-acda-11e6-8a84-bae50000006e",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "4930a9c5-acda-11e6-8a84-bae50000006e",
"name": "Поле2",
"type": "string",
"value": "values"
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000/positions",
"type": "commissionreportoutposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 144,
"commissionPeriodStart": "2016-11-01 10:07:00",
"commissionPeriodEnd": "2016-12-29 10:07:00",
"rewardType": "PercentOfSales",
"rewardPercent": 12,
"commitentSum": 2701
}
Позиции выданного отчёта комиссионера
Отдельный ресурс для управления позициями выданного отчёта комиссионера. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции
Запрос на получение списка всех позиций данного выданного отчёта комиссионера.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id выданного отчёта комиссионера. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного отчёта комиссионера.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/6348c14c-ab39-11e6-8a84-bae500000064/positions",
"type": "commissionreportoutposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/6348c14c-ab39-11e6-8a84-bae500000064/positions/94aef79a-accf-11e6-8a84-bae500000064",
"type": "commissionreportoutposition",
"mediaType": "application/json"
},
"id": "94aef79a-accf-11e6-8a84-bae500000064",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/ca976541-96d1-11e6-8a84-bae50000002e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reward": 0
}
]
}
Создать позицию
Запрос на создание новой позиции в отчёте комиссионера. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции отчёта комиссионера + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций отчёта комиссионера. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id выданного отчёта комиссионера. |
Пример создания одной позиции в выданном отчёте комиссионера.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 15,
"price": 1300,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 225
},
{
"quantity": 15,
"price": 1020,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 225
},
{
"quantity": 15,
"price": 101,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 225
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного отчёта комиссионера.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000/positions/a7a61c8b-acdd-11e6-8a84-bae500000000",
"type": "commissionreportoutposition",
"mediaType": "application/json"
},
"id": "a7a61c8b-acdd-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 15,
"price": 1300,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 2925
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000/positions/a7a6c749-acdd-11e6-8a84-bae500000001",
"type": "commissionreportoutposition",
"mediaType": "application/json"
},
"id": "a7a6c749-acdd-11e6-8a84-bae500000001",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 15,
"price": 1020,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 2295
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000/positions/a7a6d9cc-acdd-11e6-8a84-bae500000002",
"type": "commissionreportoutposition",
"mediaType": "application/json"
},
"id": "a7a6d9cc-acdd-11e6-8a84-bae500000002",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 15,
"price": 101,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 227
}
]
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id выданного отчёта комиссионера. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции выданного отчёта комиссионера. |
Запрос на удаление позиции выданного отчёта комиссионера с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции выданного отчёта комиссионера.
Позиция выданного отчёта комиссионера
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id выданного отчёта комиссионера. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции выданного отчёта комиссионера. |
Запрос на получение отдельной позиции выданного отчёта комиссионера с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции выданного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/6348c14c-ab39-11e6-8a84-bae500000064/positions/94aef79a-accf-11e6-8a84-bae500000064",
"type": "commissionreportoutposition",
"mediaType": "application/json"
},
"id": "94aef79a-accf-11e6-8a84-bae500000064",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 1,
"price": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/ca976541-96d1-11e6-8a84-bae50000002e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reward": 0
}
Изменить позицию
Запрос на обновление отдельной позиции выданного отчёта комиссионера. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id выданного отчёта комиссионера. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции выданного отчёта комиссионера. |
Пример запроса на обновление отдельной позиции в выданном отчёте комиссионера.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 14,
"price": 1301,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 0
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции выданного отчёта комиссионера.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/commissionreportout/cc5beac8-acdb-11e6-8a84-bae500000000/positions/a7a6c749-acdd-11e6-8a84-bae500000001",
"type": "commissionreportoutposition",
"mediaType": "application/json"
},
"id": "a7a6c749-acdd-11e6-8a84-bae500000001",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 14,
"price": 1301,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/36edadbe-912b-11e6-8a84-bae500000128",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
},
"reward": 0
}
Документ Прайс-лист
Средствами JSON API можно создавать и обновлять сведения о Прайс-листах, запрашивать списки Прайс-листов и сведения по отдельным Прайс-листам. Позициями Прайс-листов можно управлять как в составе отдельного Прайс-листа, так и отдельно - с помощью специальных ресурсов для управления позициями Прайс-листа. Кодом сущности для Прайс-листа в составе JSON API является ключевое слово pricelist. Больше о Прайс-листах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Прайс-листы
Атрибуты сущности
- meta - Метаданные о Прайс-листе
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - название Прайс-листа
- description - Комментарий Прайс-листа
- externalCode - Внешний код Прайс-листа
- priceType - Объект типа цены
Только для чтения- meta - Метаданные о Типе цены
Только для чтения - id - ID в формате UUID
Только для чтения - name - Наименование Типа цены
Необходимое - externalCode - Внешний код Типа цены
- meta - Метаданные о Типе цены
- columns - Массив столбцов описания таблицы
НеобходимоеТолько для чтения - moment - Дата Прайс-листа
- applicable - Отметка о проведении
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
- state - Статус Прайс-листа в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - positions - Ссылка на позиции в Прайс-листе в формате Метаданных
Позиции Прайс-листа
Позиции Прайс-листа - это список товаров/услуг/модификаций.
Объект позиции Прайс-листа содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ assortment - Ссылка на товар/услугу/модификацию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
+ cells - массив значений столбцов в позиции Прайс-листа
С позициями можно работать с помощью специальных ресурсов для управления позициями Прайс-листа, а также в составе отдельного Прайс-листа. При работе в составе отдельного Прайс-листа, вы можете отправлять запросы на создание отдельного Прайс-листа с включенным в тело запроса массивом позиций Прайс-листа. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции Прайс-листа". Также, при работе в составе отдельной Прайс-листа, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Прайс-листа. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции Прайс-листа" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
Столбцы
Поле columns - массив, содержащий в себе объекты со следующими атрибутами:
+ name - Название столбца Необходимое
+ percentageDiscount - Процентная наценка или скидка по умолчанию для столбца
На столбцы налагаются следующие ограничения: - Название столбца не может отсутствовать или быть пустым - Название столбца должно быть уникальным в пределах одного Прайс-листа - Опциональное значение percentageDiscount должно быть числом.
Ячейки
Поле cells - массив, содержащий в себе объекты со следующими атрибутами:
+ column - Название столбца, к которому относится данная ячейка Необходимое
+ sum - Числовое значение ячейки Необходимое
При создании если значения ячеек позиций Прайс-листа были не указаны, то заполнятся значениями по умолчанию те ячейки, столбцы которых имеют значение скидки(наценки) по умолчанию. Элементы массива cells соотносятся с колонками по названию по значению поля column.
О работе с доп. полями Прайс-листов можно прочитать здесь
Получить список Прайс-листов
Запрос всех Прайс-листов на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Прайс-листы.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить список Прайс-листов
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Прайс-листов.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/312cc207-afe9-11e6-8af5-581e0000002c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "312cc207-afe9-11e6-8af5-581e0000002c",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 15:51:16",
"name": "Прайс-лист от 21.21.2016 (5)",
"description": "test",
"externalCode": "m-9OZzfBiAjolWhnBjTff0",
"moment": "2016-11-21 15:51:16",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/312cc207-afe9-11e6-8af5-581e0000002c/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
},
"columns": [
{
"name": "a"
},
{
"name": "b",
"percentageDiscount": 1000
}
]
}
]
}
Создать Прайс-лист
Запрос на создание нового Прайс-листа. Обязательные для создания поля: + name - номер Прайс-листа (номер) + organization - Ссылка на ваше юрлицо в формате Метаданных + columns - Массив объектов, описывающих столбцы нового прайс-листа
Примечание: если при создании Прайс-листа указать несуществующий тип цен, то Прайс-лист создастся с типом цен продаж по умолчанию.
Пример создания нового Прайс-листа с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"columns": [
{
"name": "column without discount"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/7370448e-afe9-11e6-8af5-581e00000036",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "7370448e-afe9-11e6-8af5-581e00000036",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 15:53:07",
"name": "Прайс-лист от 21.21.2016 (6)",
"externalCode": "dj7x7PvbhjeR8u3eiVAFo3",
"moment": "2016-11-21 15:53:08",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/7370448e-afe9-11e6-8af5-581e00000036/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"columns": [
{
"name": "column without discount"
}
]
}
Пример создания нового Прайс-листа с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"shared": true,
"name": "Новый прайс-лист",
"description": "test",
"externalCode": "m-9OZzfBiAjolWhnBjTff0",
"moment": "2016-11-21 15:51:16",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"rows": [
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "without_discount",
"sum": 90000
}
]
},
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "with_discount",
"sum": 1000
},
{
"column": "without_discount",
"sum": 1000
}
]
}
]
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
},
"columns": [
{
"name": "without_discount"
},
{
"name": "with_discount",
"percentageDiscount": 1000
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/c41abcd9-afea-11e6-8af5-581e0000003c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "c41abcd9-afea-11e6-8af5-581e0000003c",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 16:02:32",
"name": "Новый прайс-лист",
"description": "test",
"externalCode": "m-9OZzfBiAjolWhnBjTff0",
"moment": "2016-11-21 15:51:16",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/c41abcd9-afea-11e6-8af5-581e0000003c/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
},
"columns": [
{
"name": "without_discount"
},
{
"name": "with_discount",
"percentageDiscount": 1000
}
]
}
Пример запроса на создание Прайс-листа с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666f86f9-afec-11e6-8af5-581e00000087",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666f86f9-afec-11e6-8af5-581e00000087",
"name": "доп строка",
"type": "string",
"value": "значение"
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666ffdb9-afec-11e6-8af5-581e00000088",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666ffdb9-afec-11e6-8af5-581e00000088",
"name": "доп число",
"type": "long",
"value": 1
}
],
"columns": [
{
"name": "стандартная колонка"
}
]
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/a6d8eee9-afee-11e6-8af5-581e00000049",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "a6d8eee9-afee-11e6-8af5-581e00000049",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 16:30:21",
"name": "Прайс-лист от 21.21.2016 (7)",
"externalCode": "dfeEd7Hvgx4bj4R8LItpZ0",
"moment": "2016-11-21 16:30:21",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666f86f9-afec-11e6-8af5-581e00000087",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666f86f9-afec-11e6-8af5-581e00000087",
"name": "доп строка",
"type": "string",
"value": "значение"
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666ffdb9-afec-11e6-8af5-581e00000088",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666ffdb9-afec-11e6-8af5-581e00000088",
"name": "доп число",
"type": "long",
"value": 1
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/a6d8eee9-afee-11e6-8af5-581e00000049/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"columns": [
{
"name": "стандартная колонка"
}
]
}
Пример запроса на создание Прайс-листа с позициями в теле запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"rows": [
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "обычная колонка",
"sum": 10000
}
]
}
]
},
"columns": [
{
"name": "обычная колонка"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/d983f7fc-afef-11e6-8af5-581e00000050",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "d983f7fc-afef-11e6-8af5-581e00000050",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 16:38:56",
"name": "Прайс-лист от 21.21.2016 (8)",
"externalCode": "rZNA7Lf3hWJwwpGy5HMoN1",
"moment": "2016-11-21 16:38:56",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/d983f7fc-afef-11e6-8af5-581e00000050/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"columns": [
{
"name": "обычная колонка"
}
]
}
Массовое создание и обновление Прайс-листов
Массовое создание и обновление Прайс-листов. В теле запроса нужно передать массив, содержащий JSON представления Прайс-листов, которые вы хотите создать или обновить. Обновляемые Прайс-листы должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Прайс-листов
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"columns": [
{
"name": "column without discount"
}
]
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/312cc207-afe9-11e6-8af5-581e0000002c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"shared": true,
"name": "Новое название",
"description": "Новое описание",
"moment": "2016-11-21 15:51:16",
"applicable": false,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}
]
'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Прайс-листов.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/7370448e-afe9-11e6-8af5-581e00000036",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "7370448e-afe9-11e6-8af5-581e00000036",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 15:53:07",
"name": "Прайс-лист от 21.21.2016 (6)",
"externalCode": "dj7x7PvbhjeR8u3eiVAFo3",
"moment": "2016-11-21 15:53:08",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/7370448e-afe9-11e6-8af5-581e00000036/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
},
"columns": [
{
"name": "column without discount"
}
]
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/312cc207-afe9-11e6-8af5-581e0000002c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "312cc207-afe9-11e6-8af5-581e0000002c",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 16:21:07",
"name": "Новое название",
"description": "Новое описание",
"externalCode": "m-9OZzfBiAjolWhnBjTff0",
"moment": "2016-11-21 15:51:16",
"applicable": false,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/312cc207-afe9-11e6-8af5-581e0000002c/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
},
"columns": [
{
"name": "a"
},
{
"name": "b",
"percentageDiscount": 1000
}
]
}
]
Удалить Прайс-лист
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Прайс-листа. |
Запрос на удаление Прайс-листа с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Прайс-листа.
Метаданные Прайс-листов
Метаданные Прайс-листов
Запрос на получение метаданных Прайс-листов. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Прайс-листов + attributes - Массив объектов доп. полей Прайс-листов в формате Метаданных + states - Массив статусов Прайс-листов + createShared - создавать новые Прайс-листы с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Прайс-листов
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Прайс-листов.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666f86f9-afec-11e6-8af5-581e00000087",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666f86f9-afec-11e6-8af5-581e00000087",
"name": "доп строка",
"type": "string",
"required": false
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666ffdb9-afec-11e6-8af5-581e00000088",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666ffdb9-afec-11e6-8af5-581e00000088",
"name": "доп число",
"type": "long",
"required": false
}
],
"createShared": false
}
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | 666f86f9-afec-11e6-8af5-581e00000087 (required, string) - id Доп. поля |
Отдельное доп. поле
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666f86f9-afec-11e6-8af5-581e00000087"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666f86f9-afec-11e6-8af5-581e00000087",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666f86f9-afec-11e6-8af5-581e00000087",
"name": "доп строка",
"type": "string",
"required": false
}
Прайс-лист
Получить Прайс-лист
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Прайс-листа. |
Запрос на получение отдельного Прайс-листа с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/312cc207-afe9-11e6-8af5-581e0000002c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "312cc207-afe9-11e6-8af5-581e0000002c",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 15:51:16",
"name": "Прайс-лист от 21.21.2016 (5)",
"description": "test",
"externalCode": "m-9OZzfBiAjolWhnBjTff0",
"moment": "2016-11-21 15:51:16",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/312cc207-afe9-11e6-8af5-581e0000002c/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
},
"columns": [
{
"name": "a"
},
{
"name": "b",
"percentageDiscount": 1000
}
]
}
Изменить Прайс-лист
Запрос на обновление Прайс-листа с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Прайс-листа, кроме тех, что
помечены Только для чтения в описании атрибутов Прайс-листа.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Прайс-листа. |
Пример запроса на обновление отдельного Прайс-листа.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"shared": true,
"name": "Новое название",
"description": "Новое описание",
"moment": "2016-11-21 15:51:16",
"applicable": false,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновленного Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/312cc207-afe9-11e6-8af5-581e0000002c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "312cc207-afe9-11e6-8af5-581e0000002c",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 16:21:07",
"name": "Новое название",
"description": "Новое описание",
"externalCode": "m-9OZzfBiAjolWhnBjTff0",
"moment": "2016-11-21 15:51:16",
"applicable": false,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/312cc207-afe9-11e6-8af5-581e0000002c/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"priceType": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/companysettings/pricetype/672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"type": "pricetype",
"mediaType": "application/json"
},
"id": "672559f1-cbf3-11e1-9eb9-889ffa6f49fd",
"name": "Цена продажи",
"externalCode": "cbcf493b-55bc-11d9-848a-00112f43529a"
},
"columns": [
{
"name": "a"
},
{
"name": "b",
"percentageDiscount": 1000
}
]
}
Пример запроса на изменение Прайс-листа с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "28bd7720-afee-11e6-8af5-581e00000093",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666f86f9-afec-11e6-8af5-581e00000087",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666f86f9-afec-11e6-8af5-581e00000087",
"name": "доп строка",
"type": "string",
"value": "новое значение"
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666ffdb9-afec-11e6-8af5-581e00000088",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666ffdb9-afec-11e6-8af5-581e00000088",
"name": "доп число",
"type": "long",
"value": 2
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновленного Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "28bd7720-afee-11e6-8af5-581e00000093",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 16:27:07",
"name": "Прайс-лист от 21.21.2016 (5)",
"externalCode": "w08cWHC6jzNZr7i7ZwTN63",
"moment": "2016-11-21 16:26:00",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666f86f9-afec-11e6-8af5-581e00000087",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666f86f9-afec-11e6-8af5-581e00000087",
"name": "доп строка",
"type": "string",
"value": "новое значение"
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666ffdb9-afec-11e6-8af5-581e00000088",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666ffdb9-afec-11e6-8af5-581e00000088",
"name": "доп число",
"type": "long",
"value": 2
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"columns": [
{
"name": "стандртная колонка"
}
]
}
Пример запроса на обновление Прайс-листа с позициями в теле запроса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions/33026e32-afee-11e6-8af5-581e0000009a",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "33026e32-afee-11e6-8af5-581e0000009a",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": []
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions/001d16d0-affe-11e6-8af5-581e0000000f",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "001d16d0-affe-11e6-8af5-581e0000000f",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "стандртная колонка",
"sum": 100000
}
]
}
]
},
"columns": [
{
"name": "стандртная колонка"
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновленного Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093?expand=positions",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata",
"type": "pricelist",
"mediaType": "application/json"
},
"id": "28bd7720-afee-11e6-8af5-581e00000093",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/9575ba6d-9609-11e6-8af5-581e000000ad",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/956169fa-9609-11e6-8af5-581e00000009",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 18:00:28",
"name": "123123",
"externalCode": "w08cWHC6jzNZr7i7ZwTN63",
"moment": "2016-11-21 16:26:00",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/95920812-9609-11e6-8af5-581e000000d4",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"attributes": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666f86f9-afec-11e6-8af5-581e00000087",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666f86f9-afec-11e6-8af5-581e00000087",
"name": "доп строка",
"type": "string",
"value": "новое значение"
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/metadata/attributes/666ffdb9-afec-11e6-8af5-581e00000088",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "666ffdb9-afec-11e6-8af5-581e00000088",
"name": "доп число",
"type": "long",
"value": 2
}
],
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions/33026e32-afee-11e6-8af5-581e0000009a",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "33026e32-afee-11e6-8af5-581e0000009a",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": []
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions/001d16d0-affe-11e6-8af5-581e0000000f",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "001d16d0-affe-11e6-8af5-581e0000000f",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "стандртная колонка",
"sum": 100000
}
]
}
]
},
"columns": [
{
"name": "стандртная колонка"
}
]
}
Позиции Прайс-листа
Отдельный ресурс для управления позициями Прайс-листа. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Прайс-листа
Запрос на получение списка всех позиций данного Прайс-листа. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Прайс-листа.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Прайс-листа. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Прайс-листа
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного Прайс-листа.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions",
"type": "pricelistrow",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions/33026e32-afee-11e6-8af5-581e0000009a",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "33026e32-afee-11e6-8af5-581e0000009a",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "стандртная колонка",
"sum": 100000
}
]
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/28bd7720-afee-11e6-8af5-581e00000093/positions/001d16d0-affe-11e6-8af5-581e0000000f",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "001d16d0-affe-11e6-8af5-581e0000000f",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "стандртная колонка",
"sum": 200000
}
]
}
]
}
Создать позицию Прайс-листа
Запрос на создание новой позиции в Прайс-листе. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/модификацию, которую представляет собой позиция. + cells - Массив ячеек цен для новой позиции. Может быть не указан, в таком случае создадутся те ячейки, у которых есть процентная наценка по умолчанию.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Прайс-листа. |
Пример создания одной позиции в Прайс-листе.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "123",
"sum": 100000
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного Прайс-листа.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/ce6e8bd8-b000-11e6-8af5-581e0000006f/positions/eb3e4026-b001-11e6-8af5-581e00000000",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "eb3e4026-b001-11e6-8af5-581e00000000",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "123",
"sum": 100000
}
]
}
]
Пример создания сразу нескольких позиций в Прайс-листе.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "123",
"sum": 100000
}
]
},
{
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "123",
"sum": 100000
}
]
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка созданных позиций отдельного Прайс-листа.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/ce6e8bd8-b000-11e6-8af5-581e0000006f/positions/7756e86b-b005-11e6-8af5-581e0000000e",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "7756e86b-b005-11e6-8af5-581e0000000e",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "123",
"sum": 100000
}
]
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/ce6e8bd8-b000-11e6-8af5-581e0000006f/positions/7756fee5-b005-11e6-8af5-581e00000010",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "7756fee5-b005-11e6-8af5-581e00000010",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "123",
"sum": 100000
}
]
}
]
Позиция Прайс-листа
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Прайс-листа. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id позиции Прайс-листа. |
Запрос на получение отдельной позиции Прайс-листа с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/d72b4281-b000-11e6-8af5-581e00000074/positions/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/ce6e8bd8-b000-11e6-8af5-581e0000006f/positions/d72b4281-b000-11e6-8af5-581e00000074",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "d72b4281-b000-11e6-8af5-581e00000074",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "123",
"sum": 100000
}
]
}
Изменить позицию
Запрос на обновление отдельной позиции Прайс-листа. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Прайс-листа. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id позиции Прайс-листа. |
Пример запроса на обновление отдельной позиции в Прайс-листе.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/d72b4281-b000-11e6-8af5-581e00000074/positions/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"cells": [
{
"column": "123",
"sum": 100002
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Прайс-листа.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/pricelist/ce6e8bd8-b000-11e6-8af5-581e0000006f/positions/d72b4281-b000-11e6-8af5-581e00000074",
"type": "pricelistrow",
"mediaType": "application/json"
},
"id": "d72b4281-b000-11e6-8af5-581e00000074",
"accountId": "9560e3e3-9609-11e6-8af5-581e00000008",
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/987148b8-9a09-11e6-8af5-581e0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"cells": [
{
"column": "123",
"sum": 100002
}
]
}
Удалить Позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Прайс-листа. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id позиции Прайс-листа. |
Запрос на удаление позиции Прайс-листа с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/pricelist/d72b4281-b000-11e6-8af5-581e00000074/positions/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Прайс-листа.
Документ Тех. карта
Средствами JSON API можно создавать и обновлять сведения о Тех. картах, запрашивать списки Тех. карт и сведения по отдельным Тех. картам. Позициями Тех. карт можно управлять как в составе отдельной Тех. карты, так и отдельно - с помощью специальных ресурсов для управления материалами и продуктами Тех. карты. Кодом сущности для Тех. карты в составе JSON API является ключевое слово processingplan. Больше о Тех. картах и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Тех. карты
Атрибуты сущности
- meta - Метаданные о Тех. карте
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - Наименование Тех. карты
Необходимое - externalCode - Внешний код Тех. карты
- pathName - Наименование группы, в которую входит Тех. карта
Только для чтения - parent - Ссылка на группу Тех. карты в формате Метаданных
- cost - Стоимость производства
- materials - Список материалов Тех. карты в формате Метаданных
Необходимое - products - Список готовых продуктов Тех. карты в формате Метаданных
Необходимое
Материалы Тех. карты
Материалы Тех. карты - это список товаров, используемых для производства готовых продуктов.
Объект материала Тех. карты содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ product - Ссылка на товар, которую представляет собой позиция, в формате Метаданных
+ quantity - Количество товаров данного вида в позиции.
Продукты Тех. карты
Продукты Тех. карты - это список товаров, получаемых при производстве.
Объект продукта Тех. карты содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ product - Ссылка на товар, которую представляет собой позиция, в формате Метаданных
+ quantity - Количество товаров данного вида в позиции.
С материалами и продуктами можно работать с помощью специальных ресурсов для управления позициями Тех. карты, а также в составе отдельной Тех. карты. При работе в составе отдельной Тех. карты, вы можете отправлять запросы на создание отдельной Тех. карты с включенными в тело запроса массивами материалов и продуктов Тех. карты. Если количество материалов или продуктов превышает максимально допустимое, то для дальнейшего пополнения материалов и продуктов нужно будет работать со специальнымы ресурсами "Материалы Тех. карты" и "Продукты Тех. карты". Также, при работе в составе отдельной Тех. карты, можно отправлять запросы на обновление списка материалов и продуктов с включенными в тело запроса массивами материалов и продуктов Тех. карты. При этом важно помнить, что коллекции материалов и продуктов полностью заменят уже существующие коллекции при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
Получить список Тех. карт
Запрос всех Тех. карт на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Тех. карты.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить список Тех. карт
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Тех. карт.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json",
"size": 3,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
},
"id": "1a18770e-ad9a-11e6-5bed-427b00000064",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 14:55:08",
"name": "Тех. карточка",
"externalCode": "4geOQkq5h7d5w1-tUATmt3",
"pathName": "",
"cost": 1000,
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064/materials",
"type": "processingplanmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064/products",
"type": "processingplanresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/6b4ffbf7-ac12-11e6-5bed-427b00000091",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
},
"id": "6b4ffbf7-ac12-11e6-5bed-427b00000091",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 14:48:32",
"name": "Тех. карта",
"externalCode": "Lr9zJa9qgpvs6f6laIgtG2",
"pathName": "Группа",
"folder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplanfolder/bfb6c5dc-acbb-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplanfolder/metadata",
"type": "processingplanfolder",
"mediaType": "application/json"
}
},
"cost": 2000,
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/6b4ffbf7-ac12-11e6-5bed-427b00000091/materials",
"type": "processingplanmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/6b4ffbf7-ac12-11e6-5bed-427b00000091/products",
"type": "processingplanresult",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
},
"id": "c38e50b0-acdc-11e6-5bed-427b0000009e",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-17 18:44:45",
"name": "Карта",
"externalCode": "QrWcKk6mhnNX2Jhi-WsIh2",
"pathName": "Группа",
"folder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplanfolder/bfb6c5dc-acbb-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplanfolder/metadata",
"type": "processingplanfolder",
"mediaType": "application/json"
}
},
"cost": 10000,
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e/materials",
"type": "processingplanmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e/products",
"type": "processingplanresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
]
}
Создать Тех. карту
Запрос на создание новой Тех. карты. Обязательные для создания поля: + name - Наименование Тех. карты + materials - Список материалов Тех. карты в формате Метаданных + products - Список готовых продуктов Тех. карты в формате Метаданных
Пример создания новой Тех.карты с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Example",
"cost": 1000,
"materials": [
{
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
],
"products": [
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0da78cd1-91f2-11e6-5bed-427b0000009a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0da78cd1-91f2-11e6-5bed-427b0000009a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Тех. карты.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
},
"id": "120a488b-b0bd-11e6-5bed-427b00000000",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-22 17:07:57",
"name": "123sdf",
"externalCode": "llZWq551h90XDJuYADvry0",
"pathName": "",
"cost": 1000,
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/materials",
"type": "processingplanmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/products",
"type": "processingplanresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Массовое создание и обновление Тех. карт
Массовое создание и обновление Тех. карт. В теле запроса нужно передать массив, содержащий JSON представления Тех. карт, которые вы хотите создать или обновить. Обновляемые Тех. карты должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Тех. карт
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"name": "Example",
"cost": 1000,
"materials": [
{
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
],
"products": [
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0da78cd1-91f2-11e6-5bed-427b0000009a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0da78cd1-91f2-11e6-5bed-427b0000009a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
},
"name": "Тех. карта",
"cost": 100000
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Тех. карт.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
},
"id": "120a488b-b0bd-11e6-5bed-427b00000000",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-22 17:07:57",
"name": "123sdf",
"externalCode": "llZWq551h90XDJuYADvry0",
"pathName": "",
"cost": 1000,
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/materials",
"type": "processingplanmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/products",
"type": "processingplanresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
},
"id": "1a18770e-ad9a-11e6-5bed-427b00000064",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 14:55:08",
"name": "Тех. карта",
"externalCode": "4geOQkq5h7d5w1-tUATmt3",
"pathName": "",
"cost": 100000,
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064/materials",
"type": "processingplanmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064/products",
"type": "processingplanresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
]
Удалить Тех. карту
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. карты. |
Запрос на удаление Тех. карты с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Тех. карты.
Тех. карта
Получить Тех. карту
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. карты. |
Запрос на получение отдельной Тех. карты с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Тех. карты.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
},
"id": "1a18770e-ad9a-11e6-5bed-427b00000064",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 14:55:08",
"name": "Тех. карточка",
"externalCode": "4geOQkq5h7d5w1-tUATmt3",
"pathName": "",
"cost": 1000,
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064/materials",
"type": "processingplanmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064/products",
"type": "processingplanresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Изменить Тех. карту
Запрос на обновление Тех. карты с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Тех. карты, кроме тех, что
помечены Только для чтения в описании атрибутов Тех. карты.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. карты. |
Пример запроса на обновление отдельной Тех. карты.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "Тех. карта",
"cost": 100000
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновленной Тех. карты.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
},
"id": "1a18770e-ad9a-11e6-5bed-427b00000064",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 14:55:08",
"name": "Тех. карта",
"externalCode": "4geOQkq5h7d5w1-tUATmt3",
"pathName": "",
"cost": 100000,
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064/materials",
"type": "processingplanmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064/products",
"type": "processingplanresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Материалы Тех. карты
Отдельный ресурс для управления материалами Тех. карты. С его помощью вы можете управлять материалами большого документа, количество материалов в котором превышает лимит на количество материалов, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить материалы Тех. карты
Запрос на получение списка всех материалов данной Тех. карты. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой материалы Тех. карты.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. карты. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить материалы Тех. карты
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/7944ef04-f831-11e5-7a69-971500188b19/materials"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка материалов отдельной Тех. карты.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/materials",
"type": "processingplanmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/materials/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanmaterial",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}
Создать материал Тех. карты
Запрос на создание нового материала в Тех. карте. Для успешного создания необходимо в теле запроса указать следующие поля: + product - Ссылка на товар, которую представляет собой позиция. + quantity - Количество товаров в позиции.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. карты. |
Пример создания одного материала в Тех. карте.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/7944ef04-f831-11e5-7a69-971500188b19/materials"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного материала отдельной Тех. карты.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/materials/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanmaterial",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
Пример создания сразу нескольких материалов в Тех. карте.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/7944ef04-f831-11e5-7a69-971500188b19/materials"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000081",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 2
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка созданных материалов отдельной Тех. карты.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/materials/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanmaterial",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/materials/120b4591-b0bd-11e6-5bed-427b00000002",
"type": "processingplanmaterial",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000002",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000081",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 2
}
]
Материал Тех. карты
Получить материал
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. карты. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id позиции Тех. карты. |
Запрос на получение отдельного материала Тех. карты с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/d72b4281-b000-11e6-8af5-581e00000074/materials/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного материала Тех. карты.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/materials/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanmaterial",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
Изменить материал
Запрос на обновление отдельного материала Тех. карты. Для обновления материала нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. карты. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id позиции Тех. карты. |
Пример запроса на обновление отдельного материала в Тех. карте.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/d72b4281-b000-11e6-8af5-581e00000074/materials/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 5
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого материала Тех. карты.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/materials/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanmaterial",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 5
}
]
Удалить материал
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. карты. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id позиции Тех. карты. |
Запрос на удаление материала Тех. карты с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/d72b4281-b000-11e6-8af5-581e00000074/materials/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление материала Тех. карты.
Продукты Тех. карты
Отдельный ресурс для управления продуктами Тех. карты. С его помощью вы можете управлять продуктами большого документа, количество продуктов в котором превышает лимит на количество продуктов, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить продукты Тех. карты
Запрос на получение списка всех продуктов данной Тех. карты. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой продукты Тех. карты.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. карты. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить продукты Тех. карты
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/7944ef04-f831-11e5-7a69-971500188b19/products"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка продуктов отдельной Тех. карты.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/products",
"type": "processingplanresult",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/products/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanresult",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
}
Создать продукт Тех. карты
Запрос на создание нового продукта в Тех. карте. Для успешного создания необходимо в теле запроса указать следующие поля: + product - Ссылка на товар, которую представляет собой позиция. + quantity - Количество товаров в позиции.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. карты. |
Пример создания одного продукта в Тех. карте.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/7944ef04-f831-11e5-7a69-971500188b19/products"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного продукта отдельной Тех. карты.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/products/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanresult",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
Пример создания сразу нескольких продуктов в Тех. карте.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/7944ef04-f831-11e5-7a69-971500188b19/products"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000081",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 2
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка созданных продуктов отдельной Тех. карты.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/products/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanresult",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/products/120b4591-b0bd-11e6-5bed-427b00000002",
"type": "processingplanresult",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000002",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000081",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 2
}
]
Продукт Тех. карты
Получить продукт
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. карты. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id продукта Тех. карты. |
Запрос на получение отдельного продукта Тех. карты с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/d72b4281-b000-11e6-8af5-581e00000074/products/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного продукта Тех. карты.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/products/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanresult",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 1
}
]
Изменить продукт
Запрос на обновление отдельного продукта Тех. карты. Для обновления продукта нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. карты. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id продукта Тех. карты. |
Пример запроса на обновление отдельного продукта в Тех. карте.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/d72b4281-b000-11e6-8af5-581e00000074/products/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 5
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого продукта Тех. карты.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/120a488b-b0bd-11e6-5bed-427b00000000/products/120b4591-b0bd-11e6-5bed-427b00000001",
"type": "processingplanresult",
"mediaType": "application/json"
},
"id": "120b4591-b0bd-11e6-5bed-427b00000001",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"product": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"quantity": 5
}
]
Удалить продукт
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. карты. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id продукта Тех. карты. |
Запрос на удаление продукта Тех. карты с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/processingplan/d72b4281-b000-11e6-8af5-581e00000074/products/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление продукта Тех. карты.
Документ Заказ на производство
Заказы на производство
Средствами JSON API можно создавать и обновлять сведения о Заказах на производство, запрашивать списки Заказов и сведения по отдельным Заказам на производство. Позициями Заказов можно управлять как в составе отдельного Заказа на производство, так и отдельно - с помощью специальных ресурсов для управления позициями Заказа. Кодом сущности для Заказа на производство в составе JSON API является ключевое слово processingorder. Больше о Заказах на производство и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Атрибуты сущности
- meta - Метаданные о Заказе на производство
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Заказа на производство
- description - Комментарий Заказа на производство
- externalCode - Внешний код Заказа на производство
- moment - Дата Заказа
- applicable - Отметка о проведении
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- store - Ссылка на склад в формате Метаданных
- state - Статус Заказа в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - processingPlan - Ссылка на тех. карту в формате Метаданных
Необходимое - positions - Ссылка на позиции в Заказе в формате Метаданных
Необходимое - deliveryPlannedMoment - Планируемая дата производства
- project - Ссылка на проект в формате Метаданных
- quantity - Объем производства #### Связи с другими документами
- processings - Массив ссылок на связанные тех. операции в формате Метаданных
Позиции Заказа на производство
Позиции Заказа - это список товаров/модификаций/серий, соответствующих материалам тех. карты.
Объект позиции Заказа содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Количество товаров/модификаций/серий данного вида в позиции
+ reserve - Резерв данной позиции
+ assortment - Ссылка на товар/модификацию/серию, которую представляет собой позиция, в формате Метаданных
+ pack - Упаковка товара
С позициями можно работать с помощью специальных ресурсов для управления позициями Заказа, а также в составе отдельного Заказа на производство. При работе в составе отдельного Заказа на производство, вы можете отправлять запросы на создание отдельного Заказа на производство с включенным в тело запроса массивом позиций Заказа. Также, при работе в составе отдельного Заказа на производство, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций Заказа. Позиции с новыми товарами не могут быть добавлены в Заказ.
О работе с доп. полями Заказов на производство можно прочитать здесь
Получить список Заказов на производство
Запрос всех Заказов на производство на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Заказы на производство.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить список Заказов на производство
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Заказов на производство.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/5fbf79f4-adac-11e6-5bed-427b0000006a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "5fbf79f4-adac-11e6-5bed-427b0000006a",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 12:17:56.000",
"name": "da",
"description": "dsa",
"externalCode": "Tzn6ewsegfp90BCJ6xgWe2",
"moment": "2016-11-18 19:30:00.000",
"applicable": true,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"deliveryPlannedMoment": "2016-11-22 12:17:00.000",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/5fbf79f4-adac-11e6-5bed-427b0000006a/positions",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"processings": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/bcd6e6b5-b002-11e6-5bed-427b0000000b",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/8450f4de-b002-11e6-5bed-427b00000000",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
}
}
]
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/80191fbd-afcf-11e6-5bed-427b00000000",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "80191fbd-afcf-11e6-5bed-427b00000000",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 12:47:22",
"name": "11da",
"description": "dsa",
"externalCode": "Tzn6ewsegfp90BCJ6xgWe2",
"moment": "2016-11-18 19:30:00.000",
"applicable": true,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"deliveryPlannedMoment": "2016-11-22 12:17:00.000",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/80191fbd-afcf-11e6-5bed-427b00000000/positions",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/8cbaa297-afc8-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "8cbaa297-afc8-11e6-5bed-427b00000064",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 11:58:36.000",
"name": "1",
"externalCode": "JZQBX9gshwrrTRcHkCcaR2",
"moment": "2016-11-21 11:47:00.000",
"applicable": true,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"deliveryPlannedMoment": "2016-11-02 11:57:00.000",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/8cbaa297-afc8-11e6-5bed-427b00000064/positions",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/b5556153-b164-11e6-5bed-427b0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "b5556153-b164-11e6-5bed-427b0000006f",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-23 13:07:57",
"name": "Заказ на производство",
"description": "Комментарий",
"externalCode": "wWAJXKZFgoOZVKd41Dzzz2",
"moment": "2016-11-23 13:00:00.000",
"applicable": true,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"deliveryPlannedMoment": "2016-11-23 13:07:00",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/b5556153-b164-11e6-5bed-427b0000006f/positions",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "c7201428-afcc-11e6-5bed-427b00000068",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:46:15.000",
"name": "2",
"externalCode": "5nSDOrCfjyxt0W1RbY7XZ3",
"moment": "2016-11-21 12:27:00.000",
"applicable": true,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"deliveryPlannedMoment": "2016-11-02 17:43:00.000",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068/positions",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"processings": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
}
}
]
}
]
}
Создать Заказ на производство
Запрос на создание нового Заказа на производство. Обязательные для создания поля: + organization - Ссылка на ваше юрлицо в формате Метаданных + processingPlan - Ссылка на тех. карту в формате Метаданных + positions - Ссылка на позиции в Заказе в формате Метаданных
Пример создания нового Заказа с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 111,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Заказа на производство.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}
Пример создания нового Заказа с более насыщенным телом запроса.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "000034",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 111,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Заказа на производство.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}
Пример запроса на создание Заказа на производство с доп. полями.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 111,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"attributes": [
{
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"value": "Атрибут заказа",
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного Заказа на производство.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"value": "Атрибут заказа",
}
]
}
Массовое создание и обновление Заказов на производство
Массовое создание и обновление Заказов на производство. В теле запроса нужно передать массив, содержащий JSON представления Заказов на производство, которые вы хотите создать или обновить. Обновляемые Заказы на производство должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Заказов на производство
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"type": "organization",
"mediaType": "application/json"
}
},
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 111,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
}
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"name": "000034",
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Заказов на производство.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}
]
Удалить Заказ на производство
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа на производство. |
Запрос на удаление Заказа на производство с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Заказа на производство.
Метаданные Заказов на производство
Метаданные Заказов на производство
Запрос на получение метаданных Заказов на производство. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Заказов на производство + attributes - Массив объектов доп. полей Заказов на производство в формате Метаданных + states - Массив статусов Заказов на производство + createShared - создавать новые Заказы на производство с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Заказов на производство
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Заказов на производство.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "Атрибут заказа",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новый",
"color": 15106326,
"stateType": "Regular",
"entityType": "processingorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтвержден",
"color": 40931,
"stateType": "Regular",
"entityType": "processingorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56cf4f-2e58-11e6-8a84-bae50000006b",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cf4f-2e58-11e6-8a84-bae50000006b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Собран",
"color": 8767198,
"stateType": "Regular",
"entityType": "processingorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56d433-2e58-11e6-8a84-bae50000006c",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d433-2e58-11e6-8a84-bae50000006c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отгружен",
"color": 10774205,
"stateType": "Regular",
"entityType": "processingorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56d92f-2e58-11e6-8a84-bae50000006d",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d92f-2e58-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Доставлен",
"color": 8825440,
"stateType": "Successful",
"entityType": "processingorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56de0a-2e58-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56de0a-2e58-11e6-8a84-bae50000006e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Возврат",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "processingorder"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56e2b4-2e58-11e6-8a84-bae50000006f",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56e2b4-2e58-11e6-8a84-bae50000006f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отменен",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "processingorder"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/attributes/57ab884e-558b-11e6-8a84-bae500000078",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "57ab884e-558b-11e6-8a84-bae500000078",
"name": "Товар по акции",
"type": "productfolder",
"required": false
}
Шаблон Заказа на производство
Шаблон Заказа на производство на основе
Запрос на получение предзаполненного заказа на основе другого документа. В результате запроса будет создан предзаполненный шаблон заказа на основе переданного документа.
Запрос на получение шаблона заказа на основе тех. карты.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/5fbf79f4-adac-11e6-5bed-427b0000006a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного заказа.
{
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-12-05 14:35:47",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"rows": [
{
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
}
Заказ на производство
Получить Заказ на производство
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа на производство. |
Запрос на получение отдельного Заказа на производство с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Заказа на производство.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/b5556153-b164-11e6-5bed-427b0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "b5556153-b164-11e6-5bed-427b0000006f",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-23 13:07:57",
"name": "Заказ на производство",
"description": "Комментарий",
"externalCode": "wWAJXKZFgoOZVKd41Dzzz2",
"moment": "2016-11-23 13:00:00",
"applicable": true,
"store": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"deliveryPlannedMoment": "2016-11-23 13:07:00",
"positions": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/b5556153-b164-11e6-5bed-427b0000006f/positions",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}
Изменить Заказ на производство
Запрос на обновление Заказа на производство с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Заказа на производство, кроме тех, что
помечены Только для чтения в описании атрибутов Заказа на производство.
При обновлении поля organization нужно также обновить поле organizationAccount, иначе произойдёт ошибка.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа на производство. |
Пример запроса на обновление отдельного Заказа на производство.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "000034",
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Заказа на производство.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}
Пример запроса на изменение Заказа на производство с дополнительными полями.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"attributes": [
{
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"value": "Обновлённый Атрибут заказа",
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Заказа на производство.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"attributes": [
{
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"value": "Обновлённый Атрибут заказа",
}
]
}
Пример запроса на обновление Заказа на производство с позициями в теле запроса.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"positions": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"quantity": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/8b382799-f7d2-11e5-8a84-bae5000003a5",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f6344f-015e-11e6-9464-e4de0000007c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000007c",
"quantity": 20,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f6344f-015e-11e6-9464-e4de0000008c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000008c",
"quantity": 30,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого Заказа на производство.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
},
"id": "c49e83b3-01af-11e6-9464-e4de00000026",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"syncId": "734a9e26-45a2-4ead-849c-e144daeb854d",
"updated": "2016-04-14 13:08:58",
"name": "000034",
"externalCode": "DAD9peGij6sDNii49Dkam2",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/faba7f37-2e58-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/f97aa1fb-2e58-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-04-19 13:50:24",
"applicable": false,
"sum": 0,
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
}
},
"organizationAccount": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/850c8195-f504-11e5-8a84-bae50000015e/accounts/3a30e844-016f-11e6-9464-e4de00000068",
"type": "account",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/c49e83b3-01af-11e6-9464-e4de00000026/positions",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}
Позиции Заказа на производство
Отдельный ресурс для управления позициями Заказа на производство. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает лимит на количество строк, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции Заказа на производство
Запрос на получение списка всех позиций данного Заказа на производство. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции Заказа на производство.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа на производство. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить позиции Заказа на производство
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного Заказа на производство.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068/positions",
"type": "processingorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068/positions/c7218ccd-afcc-11e6-5bed-427b00000069",
"type": "processingorderposition",
"mediaType": "application/json"
},
"id": "c7218ccd-afcc-11e6-5bed-427b00000069",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 45,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 45
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068/positions/c72196c6-afcc-11e6-5bed-427b0000006a",
"type": "processingorderposition",
"mediaType": "application/json"
},
"id": "c72196c6-afcc-11e6-5bed-427b0000006a",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 45,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/1267a23f-acdc-11e6-5bed-427b00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 45
}
]
}
Позиция Заказа на производство
Отдельная позиция Заказа с указанным id позиции.
Получить позицию Заказа на производство
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа на производство. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа на производство. |
Запрос на получение отдельной позиции Заказа с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции Заказа на производство.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068/positions/c7218ccd-afcc-11e6-5bed-427b00000069",
"type": "processingorderposition",
"mediaType": "application/json"
},
"id": "c7218ccd-afcc-11e6-5bed-427b00000069",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 45,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 45
}
Изменить позицию Заказа на производство
Запрос на обновление отдельной позиции Заказа. Для обновления позиции нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа на производство. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа на производство. |
Пример запроса на обновление отдельной позиции в Заказе на производство.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"quantity": 111,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции Заказа на производство.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/34efe2ee-015e-11e6-9464-e4de0000006b/positions/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorderposition",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 111,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
},
"reserve": 0
}
Удалить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Заказа на производство. |
| positionID | string (required) Example: 34f6344f-015e-11e6-9464-e4de0000006c id позиции Заказа на производство. |
Запрос на удаление позиции Заказа на производство с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/processingorder/7944ef04-f831-11e5-7a69-971500188b19/positions/34f6344f-015e-11e6-9464-e4de0000006c"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции Заказа на производство.
Документ Тех. операция
Средствами JSON API можно создавать и обновлять сведения о Тех. операциях, запрашивать списки Тех. операций и сведения по отдельным Тех. операциям. Позициями Тех. операций можно управлять как в составе отдельной Тех. операции, так и отдельно - с помощью специальных ресурсов для управления материалами и продуктами Тех. операции. Кодом сущности для Тех. операции в составе JSON API является ключевое слово processing. Больше о Тех. операциях и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по этой ссылке.
Тех. операции
Атрибуты сущности
- meta - Метаданные о Заказе на производство
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер Тех. операции на производство
- description - Комментарий Тех. операции на производство
- externalCode - Внешний код Тех. операции на производство
- moment - Дата Тех. операции
- applicable - Отметка о проведении
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
- state - Статус Тех. операции в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - quantity - Объем производства
Необходимое - processingSum - Затраты на производство
Необходимое - materials - Список материалов Тех. операции в формате Метаданных
Необходимое - products - Список готовых продуктов Тех. операции в формате Метаданных
Необходимое - productsStore - Ссылка на склад для продукции в формате Метаданных
Необходимое - materialsStore - Ссылка на склад для материалов в формате Метаданных
Необходимое - processingPlan - Ссылка на Тех. операцию в формате Метаданных
Необходимое - project - Ссылка на проект в формате Метаданных #### Связи с другими документами
- processingOrder - Ссылка на заказ на производство в формате Метаданных
Материалы Тех. операции
Материалы Тех. операции - это список товаров/модификаций/серий, используемых для производства готовых продуктов согласно тех. карте.
Объект материала Тех. операции содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ assortment - Ссылка на товар/модификацию/серию, которую представляет собой позиция, в формате Метаданных
+ quantity - Количество товаров данного вида в позиции.
Продукты Тех. операции
Продукты Тех. операции - это список товаров/модификаций/серий, получаемых при производстве согласно тех. карте.
Объект продукта Тех. операции содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ assortment - Ссылка на товар/модификацию/серию, которую представляет собой позиция, в формате Метаданных
+ quantity - Количество товаров данного вида в позиции.
С материалами и продуктами можно работать с помощью специальных ресурсов для управления позициями Тех. операции, а также в составе отдельной Тех. операции. При работе в составе отдельной Тех. операции, вы можете отправлять запросы на создание отдельной Тех. операции с включенными в тело запроса массивами материалов и продуктов Тех. операции. Также, при работе в составе отдельной Тех. операции, можно отправлять запросы на обновление списка материалов и продуктов с включенными в тело запроса массивами материалов и продуктов Тех. операции. Состав материалов и продуктов Тех. операции не может быть изменён. Состав материалов и продуктов должен соответствовать тех. карте.
Получить список Тех. операций
Запрос всех Тех. операций на данной учётной записи. Результат: Объект JSON, включающий в себя поля: - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Тех. операции.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить список Тех. операций
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processing"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Тех. операций.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json",
"size": 6,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "493ddf6b-aff9-11e6-5bed-427b00000076",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:46:29.000",
"name": "я1",
"externalCode": "JhQJY8u1isyuqHyn7B6Wx3",
"moment": "2016-11-21 17:46:00.000",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 10000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/8450f4de-b002-11e6-5bed-427b00000000",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "8450f4de-b002-11e6-5bed-427b00000000",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 18:52:33.000",
"name": "я2",
"externalCode": "pJCPjt45j2MH-RF6joC801",
"moment": "2016-11-21 18:51:23.000",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 1000,
"quantity": 3,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/5fbf79f4-adac-11e6-5bed-427b0000006a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/8450f4de-b002-11e6-5bed-427b00000000/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/8450f4de-b002-11e6-5bed-427b00000000/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/86e98bad-acc4-11e6-5bed-427b0000006f",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "86e98bad-acc4-11e6-5bed-427b0000006f",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:18:59.000",
"name": "3",
"description": "123",
"externalCode": "wI2vDDTVgkW48xeO4nQx83",
"moment": "2016-11-17 18:15:00.000",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 77800,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/6b4ffbf7-ac12-11e6-5bed-427b00000091",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/86e98bad-acc4-11e6-5bed-427b0000006f/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/86e98bad-acc4-11e6-5bed-427b0000006f/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/bcd6e6b5-b002-11e6-5bed-427b0000000b",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "bcd6e6b5-b002-11e6-5bed-427b0000000b",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 18:57:52",
"name": "я3",
"externalCode": "299q4AXMhEnfW6V49y5nK3",
"moment": "2016-11-21 18:51:00",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 1000,
"quantity": 3,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/5fbf79f4-adac-11e6-5bed-427b0000006a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/bcd6e6b5-b002-11e6-5bed-427b0000000b/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/bcd6e6b5-b002-11e6-5bed-427b0000000b/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/e0ecaec9-acdc-11e6-5bed-427b000000a5",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "e0ecaec9-acdc-11e6-5bed-427b000000a5",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 16:56:54.000",
"name": "1234",
"externalCode": "P81TjGDDiO5p7oUzSsvtk3",
"moment": "2016-11-17 18:44:00.000",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 0,
"quantity": 2,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/e0ecaec9-acdc-11e6-5bed-427b000000a5/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/e0ecaec9-acdc-11e6-5bed-427b000000a5/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 0,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/e4f01df6-adb0-11e6-5bed-427b0000007a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "e4f01df6-adb0-11e6-5bed-427b0000007a",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-18 20:03:14.000",
"name": "я",
"externalCode": "9VU4bcd7jcC3nOhk5M2Ul0",
"moment": "2016-11-18 19:59:00.000",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 10000,
"quantity": 4,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/e4f01df6-adb0-11e6-5bed-427b0000007a/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/e4f01df6-adb0-11e6-5bed-427b0000007a/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
]
}
Создать Тех. операцию
Запрос на создание новой Тех. операции. Обязательные для создания поля: + organization - Ссылка на ваше юрлицо в формате Метаданных + processingSum - Затраты на производство + quantity - Объем производства + processingPlan - Ссылка на Тех. операцию в формате Метаданных + productsStore - Ссылка на склад для продукции в формате Метаданных + materialsStore - Ссылка на склад для материалов в формате Метаданных + materials - Список материалов Тех. операции в формате Метаданных + products - Список готовых продуктов Тех. операции в формате Метаданных
Пример создания новой Тех.операции с телом запроса, содержащим только необходимые поля.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processing"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 10000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"quantity": 3,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/160ff7bb-acdc-11e6-5bed-427b0000008c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 2,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/18fce7bf-acdc-11e6-5bed-427b00000092",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
},
"materials": {
"meta": {
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"quantity": 4,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/1267a23f-acdc-11e6-5bed-427b00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Тех. операции.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "493ddf6b-aff9-11e6-5bed-427b00000076",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:46:29",
"name": "Это технологическая операция",
"externalCode": "JhQJY8u1isyuqHyn7B6Wx3",
"moment": "2016-11-21 17:46:00",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 10000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Пример создания новой Тех.операции.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processing"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:46:29",
"name": "Это технологическая операция",
"externalCode": "JhQJY8u1isyuqHyn7B6Wx3",
"moment": "2016-11-21 17:46:00",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 10000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"quantity": 3,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/160ff7bb-acdc-11e6-5bed-427b0000008c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 2,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/18fce7bf-acdc-11e6-5bed-427b00000092",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
},
"materials": {
"meta": {
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"quantity": 4,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/1267a23f-acdc-11e6-5bed-427b00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной Тех. операции.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "493ddf6b-aff9-11e6-5bed-427b00000076",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:46:29",
"name": "Это технологическая операция",
"externalCode": "JhQJY8u1isyuqHyn7B6Wx3",
"moment": "2016-11-21 17:46:00",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 10000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Массовое создание и обновление Тех.операций
Массовое создание и обновление Тех.операций. В теле запроса нужно передать массив, содержащий JSON представления Тех.операций, которые вы хотите создать или обновить. Обновляемые Тех.операции должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких Тех.операций
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/processing"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 10000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"quantity": 3,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/160ff7bb-acdc-11e6-5bed-427b0000008c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 2,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/18fce7bf-acdc-11e6-5bed-427b00000092",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
},
"materials": {
"meta": {
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"quantity": 4,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/1267a23f-acdc-11e6-5bed-427b00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"name": "000034",
"quantity": 5,
"processingSum": 2000
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных Тех.операций.
[
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "493ddf6b-aff9-11e6-5bed-427b00000076",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:46:29",
"name": "Это технологическая операция",
"externalCode": "JhQJY8u1isyuqHyn7B6Wx3",
"moment": "2016-11-21 17:46:00",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 10000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "493ddf6b-aff9-11e6-5bed-427b00000076",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:46:29",
"name": "000034",
"externalCode": "JhQJY8u1isyuqHyn7B6Wx3",
"moment": "2016-11-21 17:46:00",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 2000,
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
]
Удалить Тех. операцию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. операции. |
Запрос на удаление Тех. операции с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/processing/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Тех. операции.
Метаданные Тех. операций
Метаданные Тех. операций
Запрос на получение метаданных Тех. операций. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные Тех. операций + attributes - Массив объектов доп. полей Тех. операций в формате Метаданных + states - Массив статусов Тех. операций + createShared - создавать новые Тех. операции с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные Тех. операций
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление доп. полей Тех. операций.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"id": "c2ecd338-015e-11e6-9464-e4de0000008f",
"name": "Атрибут заказа",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata/states/fb56c504-2e58-11e6-8a84-bae500000069",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56c504-2e58-11e6-8a84-bae500000069",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Новая",
"color": 15106326,
"stateType": "Regular",
"entityType": "processing"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata/states/fb56cae3-2e58-11e6-8a84-bae50000006a",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cae3-2e58-11e6-8a84-bae50000006a",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Подтверждена",
"color": 40931,
"stateType": "Regular",
"entityType": "processing"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata/states/fb56cf4f-2e58-11e6-8a84-bae50000006b",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56cf4f-2e58-11e6-8a84-bae50000006b",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Собрана",
"color": 8767198,
"stateType": "Regular",
"entityType": "processing"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata/states/fb56d433-2e58-11e6-8a84-bae50000006c",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d433-2e58-11e6-8a84-bae50000006c",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отгружена",
"color": 10774205,
"stateType": "Regular",
"entityType": "processing"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata/states/fb56d92f-2e58-11e6-8a84-bae50000006d",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56d92f-2e58-11e6-8a84-bae50000006d",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Доставлена",
"color": 8825440,
"stateType": "Successful",
"entityType": "processing"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata/states/fb56de0a-2e58-11e6-8a84-bae50000006e",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56de0a-2e58-11e6-8a84-bae50000006e",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Возврат",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "processing"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata/states/fb56e2b4-2e58-11e6-8a84-bae50000006f",
"type": "state",
"mediaType": "application/json"
},
"id": "fb56e2b4-2e58-11e6-8a84-bae50000006f",
"accountId": "f976ed28-2e58-11e6-8a84-bae500000001",
"name": "Отменена",
"color": 15280409,
"stateType": "Unsuccessful",
"entityType": "processing"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata/attributes/57ab884e-558b-11e6-8a84-bae500000078",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "57ab884e-558b-11e6-8a84-bae500000078",
"name": "Сопутствующий товар",
"type": "productfolder",
"required": false
}
Шаблон Тех. операции
Шаблон Тех. операции на основе
Запрос на получение предзаполненной тех. операции на основе другого документа. В результате запроса будет создан предзаполненный шаблон тех. операции на основе переданного документа.
Запрос на получение шаблона тех. операции на основе заказа на производство.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processing/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/5fbf79f4-adac-11e6-5bed-427b0000006a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной тех. операции.
{
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-12-05 14:35:47",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 1000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/5fbf79f4-adac-11e6-5bed-427b0000006a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"rows": [
{
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0da78cd1-91f2-11e6-5bed-427b0000009a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0da78cd1-91f2-11e6-5bed-427b0000009a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
},
"materials": {
"rows": [
{
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
}
Запрос на получение шаблона тех. операции на основе тех. карты.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processing/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/5fbf79f4-adac-11e6-5bed-427b0000006a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненной тех. операции.
{
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-12-05 14:35:47",
"applicable": true,
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 1000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/1a18770e-ad9a-11e6-5bed-427b00000064",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"products": {
"rows": [
{
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0da78cd1-91f2-11e6-5bed-427b0000009a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0da78cd1-91f2-11e6-5bed-427b0000009a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
},
"materials": {
"rows": [
{
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
}
Тех. операция
Получить Тех. операцию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. операции. |
Запрос на получение отдельной Тех. операции с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processing/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Тех. операции.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "493ddf6b-aff9-11e6-5bed-427b00000076",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:46:29",
"name": "я1",
"externalCode": "JhQJY8u1isyuqHyn7B6Wx3",
"moment": "2016-11-21 17:46:00",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 10000,
"quantity": 1,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Изменить Тех. операцию
Запрос на обновление Тех. операции с указанным id.
В теле запроса можно указать только те поля, которые необходимо изменить у Тех. операции, кроме тех, что
помечены Только для чтения в описании атрибутов Тех. операции.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. операции. |
Пример запроса на обновление отдельной Тех. операции.
curl -X PUt
"https://online.moysklad.ru/api/remap/1.2/entity/processing/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"name": "000034",
"quantity": 5,
"processingSum": 2000
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновленной Тех. операции.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processing",
"mediaType": "application/json"
},
"id": "493ddf6b-aff9-11e6-5bed-427b00000076",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"owner": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/employee/d5ad957e-91f1-11e6-5bed-427b0000002a",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/group/d55da707-91f1-11e6-5bed-427b00000001",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-21 17:46:29",
"name": "000034",
"externalCode": "JhQJY8u1isyuqHyn7B6Wx3",
"moment": "2016-11-21 17:46:00",
"applicable": true,
"project": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/project/7f3a7d7a-97a1-11e6-5bed-427b0000009c",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/organization/a1331985-a1c8-11e6-5bed-427b00000084",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"processingSum": 2000,
"quantity": 5,
"processingPlan": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/c38e50b0-acdc-11e6-5bed-427b0000009e",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingplan/metadata",
"type": "processingplan",
"mediaType": "application/json"
}
},
"productsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/c61ce912-a747-11e6-5bed-427b000000a8",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"materialsStore": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/store/d5e311c0-91f1-11e6-5bed-427b00000053",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"processingOrder": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/c7201428-afcc-11e6-5bed-427b00000068",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/processingorder/metadata",
"type": "processingorder",
"mediaType": "application/json"
}
},
"products": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"materials": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
}
}
Материалы Тех. операции
Отдельный ресурс для управления материалами Тех. операции. С его помощью вы можете управлять материалами большого документа, количество материалов в котором превышает лимит на количество материалов, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить материалы Тех. операции
Запрос на получение списка всех материалов данной Тех. операции. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой материалы Тех. операции.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. операции. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить материалы Тех. операции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processing/7944ef04-f831-11e5-7a69-971500188b19/materials"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка материалов отдельной Тех. операции.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials",
"type": "processingpositionmaterial",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials/493de99a-aff9-11e6-5bed-427b00000077",
"type": "processingpositionmaterial",
"mediaType": "application/json"
},
"id": "493de99a-aff9-11e6-5bed-427b00000077",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 4,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/materials/493defc4-aff9-11e6-5bed-427b00000078",
"type": "processingpositionmaterial",
"mediaType": "application/json"
},
"id": "493defc4-aff9-11e6-5bed-427b00000078",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 1,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/1267a23f-acdc-11e6-5bed-427b00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
Материал Тех. операции
Получить материал
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. операции. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id позиции Тех. операции. |
Запрос на получение отдельного материала Тех. операции с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processing/d72b4281-b000-11e6-8af5-581e00000074/materials/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного материала Тех. операции.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/c7201428-afcc-11e6-5bed-427b00000068/materials/c7218ccd-afcc-11e6-5bed-427b00000069",
"type": "processingpositionmaterial",
"mediaType": "application/json"
},
"id": "c7218ccd-afcc-11e6-5bed-427b00000069",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 45,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Изменить материал
Запрос на обновление отдельного материала Тех. операции. Для обновления материала нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. операции. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id позиции Тех. операции. |
Пример запроса на обновление отдельного материала в Тех. операции.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processing/d72b4281-b000-11e6-8af5-581e00000074/materials/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/34efe2ee-015e-11e6-9464-e4de0000006b/materials/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processingpositionmaterial",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"quantity": 111,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого материала Тех. операции.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/34efe2ee-015e-11e6-9464-e4de0000006b/materials/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processingpositionmaterial",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 111,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Продукты Тех. операции
Отдельный ресурс для управления продуктами Тех. операции. С его помощью вы можете управлять продуктами большого документа, количество продуктов в котором превышает лимит на количество продуктов, сохраняемых вместе с документом. Этот лимит равен 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить продукты Тех. операции
Запрос на получение списка всех продуктов данной Тех. операции. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой продукты Тех. операции.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Тех. операции. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить продукты Тех. операции
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processing/7944ef04-f831-11e5-7a69-971500188b19/products"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка продуктов отдельной Тех. операции.
{
"context": {
"employee": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products",
"type": "processingpositionresult",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products/493de99a-aff9-11e6-5bed-427b00000077",
"type": "processingpositionresult",
"mediaType": "application/json"
},
"id": "493de99a-aff9-11e6-5bed-427b00000077",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 4,
"price": 10000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/493ddf6b-aff9-11e6-5bed-427b00000076/products/493defc4-aff9-11e6-5bed-427b00000078",
"type": "processingpositionresult",
"mediaType": "application/json"
},
"id": "493defc4-aff9-11e6-5bed-427b00000078",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 1,
"price": 10000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/1267a23f-acdc-11e6-5bed-427b00000086",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
Продукт Тех. операции
Получить продукт
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. операции. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id продукта Тех. операции. |
Запрос на получение отдельного продукта Тех. операции с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/processing/d72b4281-b000-11e6-8af5-581e00000074/products/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного продукта Тех. операции.
{
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/processing/c7201428-afcc-11e6-5bed-427b00000068/products/c7218ccd-afcc-11e6-5bed-427b00000069",
"type": "processingpositionresult",
"mediaType": "application/json"
},
"id": "c7218ccd-afcc-11e6-5bed-427b00000069",
"accountId": "d55cbfba-91f1-11e6-5bed-427b00000000",
"quantity": 45,
"price": 10000,
"assortment": {
"meta": {
"href": "http://online.moysklad.ru/api/remap/1.2/entity/product/0de151c1-acdc-11e6-5bed-427b00000080",
"metadataHref": "http://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Изменить продукт
Запрос на обновление отдельного продукта Тех. операции. Для обновления продукта нет каких-либо обязательных для указания в теле запроса полей. Только те, что вы желаете обновить.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: d72b4281-b000-11e6-8af5-581e00000074 id Тех. операции. |
| positionID | string (required) Example: 9560e3e3-9609-11e6-8af5-581e00000008 id продукта Тех. операции. |
Пример запроса на обновление отдельного продукта в Тех. операции.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/processing/d72b4281-b000-11e6-8af5-581e00000074/products/9560e3e3-9609-11e6-8af5-581e00000008"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/34efe2ee-015e-11e6-9464-e4de0000006b/products/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processingpositionresult",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"quantity": 111,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого продукта Тех. операции.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/processing/34efe2ee-015e-11e6-9464-e4de0000006b/products/34f6344f-015e-11e6-9464-e4de0000006c",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/processing/metadata",
"type": "processingpositionresult",
"mediaType": "application/json"
},
"id": "34f6344f-015e-11e6-9464-e4de0000006c",
"accountId": "84e60e93-f504-11e5-8a84-bae500000008",
"quantity": 111,
"price": 10000,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Документ Внутренний заказ
Средствами JSON API можно создавать и обновлять сведения о внутренних заказах, запрашивать списки внутренних заказов и сведения по отдельным внутренним заказам. Позициями внутренних заказов можно управлять как в составе отдельного заказа, так и с помощью специальных ресурсов для управления позициями. Кодом сущности для внутреннего заказа в составе JSON API является ключевое слово internalorder.
Внутренние заказы
Атрибуты сущности
- meta - Метаданные о внутреннем заказе
- id - ID в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - syncId - ID синхронизации. После заполнения недоступен для изменения.
- updated - Момент последнего обновления сущности
Только для чтения - deleted - Момент последнего удаления сущности
Только для чтения - name - номер внутреннего заказа
Необходимое - description - Комментарий к внутреннему заказу
- externalCode - Внешний код внутреннего заказа
- moment - Дата внутреннего заказа
- applicable - Отметка о проведении
- sum - Сумма внутреннего заказа в копейках
Только для чтения - rate - Валюта
- owner - Ссылка на Владельца (Сотрудника) в формате Метаданных
- shared - Общий доступ
- group - Отдел сотрудника в формате Метаданных
- organization - Ссылка на ваше юрлицо в формате Метаданных
Необходимое - store - Ссылка на склад в формате Метаданных
- project - Ссылка на проект в формате Метаданных
- state - Статус внутреннего заказа в формате Метаданных
- attributes - Коллекция доп. полей в формате Метаданных
Поля при expand'е:- name - номер документа
- moment - дата печати
- href - ссылка на файл печатной формы
- fileName - название файла печатной формы
- updated - дата последнего изменения
- created - Дата создания
Только для чтения - positions - Ссылка на позиции внутреннего заказа в формате Метаданных
- vatSum - Сумма НДС
Только для чтения - vatEnabled - Учитывается ли НДС
- vatIncluded - Включен ли НДС в цену
- deliveryPlannedMoment - Планируемая дата приёмки
- purchaseOrders - Коллекция ссылок на связанные заказы поставщику в формате Метаданных
- moves - Коллекция ссылок на связанные перемещения в формате Метаданных
Позиции внутреннего заказа
Позиции внутреннего заказа - это список товаров/услуг/модификаций/серий.
Объект позиции внутреннего заказа содержит следующие поля:
+ id - ID товара в формате UUID Только для чтения
+ accountId - ID учетной записи Только для чтения
+ quantity - Фактическое количество товаров/услуг/модификаций/серий.
+ price - Цена товара/услуги в копейках
+ vat - НДС
+ assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. в формате Метаданных
+ pack - Упаковка товара
С позициями можно работать с помощью специальных ресурсов для управления позициями Внутреннего заказа, а также в составе отдельного внутреннего заказа. При работе в составе отдельного внутреннего заказа, вы можете отправлять запросы на создание отдельного внутреннего заказа с включенным в тело запроса массивом позиций внутреннего заказа. Если количество позиций превышает максимально допустимое, то для дальнейшего пополнения позиций нужно будет работать со специальным ресурсом "Позиции внутреннего заказа". Также, при работе в составе отдельного внутреннего заказа, можно отправлять запросы на обновление списка позиций с включенным в тело запроса массивом позиций внутреннего заказа. При этом важно помнить, что коллекция позиций будет восприниматься как "все позиции внутреннего заказа" и полностью заменит уже существующую коллекцию при обновлении объекта - лишние позиции будут удалены, новые добавлены, существующие - изменены.
О работе с доп. полями внутренних заказов можно прочитать здесь
Получить внутренние заказы
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить внутренние заказы
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка внутренних заказов.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
},
"id": "31d58bde-b2fd-11e6-8a84-bae500000068",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 13:52:01",
"name": "00002",
"description": "Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411hS2",
"moment": "2016-11-25 13:50:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068/positions",
"type": "internalorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-11-30 13:50:00"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
},
"id": "64e426af-b0d8-11e6-8a84-bae500000064",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-22 21:04:24",
"name": "00001",
"externalCode": "80QQopc4h8yBc0LnmTPpT3",
"moment": "2016-11-22 20:23:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/baac25f0-50ac-11e5-300d-c79b00000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
}
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions",
"type": "internalorderposition",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"moves": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/a3b68a79-b0dc-11e6-8a84-bae5000000cd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
}
}
]
}
]
}
Создать внутренний заказ
Запрос на создание нового внутреннего заказа.
Пример создания нового внутреннего заказа.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "000222",
"description": "Мой Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/fc635ded-acf7-11e6-8a84-bae500000075",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-11-30 13:50:00"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданного внутреннего заказа.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/eb75f6b8-b2ff-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
},
"id": "eb75f6b8-b2ff-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 14:11:31",
"name": "000222",
"description": "Мой Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63.45
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/eb75f6b8-b2ff-11e6-8a84-bae500000000/positions",
"type": "internalorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-11-30 13:50:00"
}
Шаблон внутреннего заказа
Шаблон внутреннего заказа
Запрос на получение шаблона внутреннего заказа.
Пример создания нового внутреннего заказа.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 200 (application/json) Успешный запрос. Результат - JSON представление предзаполненного шаблона внутреннего заказа.
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"moment": "2016-11-25 14:59:18",
"applicable": true,
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": {
"rows": []
},
"vatEnabled": true,
"vatIncluded": true
}
Массовое создание и обновление внутренних заказов
Массовое создание и обновление внутренних заказов. В теле запроса нужно передать массив, содержащий JSON представления внутренних заказов, которые вы хотите создать или обновить. Обновляемые внутренние заказы должны содержать идентификатор в виде метаданных.
Пример создания и обновления нескольких внутренних заказов
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/new"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "000222",
"description": "Мой Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/fc635ded-acf7-11e6-8a84-bae500000075",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
}
}
},
{
"quantity": 1,
"price": 0,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-11-30 13:50:00"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
},
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "700222",
"description": "Мой обновлённый Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 2230,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-12-30 13:52:00"
}
]'
Response 200 (application/json) Успешный запрос. Результат - массив JSON представлений созданных и обновленных внутренних заказов.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/eb75f6b8-b2ff-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
},
"id": "eb75f6b8-b2ff-11e6-8a84-bae500000000",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 14:11:31",
"name": "000222",
"description": "Мой Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63.45
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/eb75f6b8-b2ff-11e6-8a84-bae500000000/positions",
"type": "internalorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-11-30 13:50:00"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
},
"id": "64e426af-b0d8-11e6-8a84-bae500000064",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 14:48:02",
"name": "700222",
"description": "Мой обновлённый Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63.45
},
"sum": 2230,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions",
"type": "internalorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-12-30 13:52:00",
"moves": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/a3b68a79-b0dc-11e6-8a84-bae5000000cd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
}
}
]
}
]
Удалить внутренний заказ
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id внутреннего заказа. |
Запрос на удаление внутреннего заказа с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b1"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление внутреннего заказа.
Метаданные внутренних заказов
Метаданные внутренних заказов
Запрос на получение метаданных внутренних заказов. Результат - объект JSON, включающий в себя: + meta - Ссылка на метаданные внутренних заказов + attributes - Массив объектов доп. полей внутренних заказов в формате Метаданных + states - Массив статусов внутренних заказов + createShared - создавать новые внутренние заказы с меткой "Общий"
Структура отдельного объекта, представляющего доп. поле подробно описана в разделе Работа с дополнительными полями.
Метаданные внутренних заказов
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление метаданных внутренних заказов.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"mediaType": "application/json"
},
"attributes": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/attributes/68d142e7-b300-11e6-8a84-bae50000008b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "68d142e7-b300-11e6-8a84-bae50000008b",
"name": "Доп поле внут заказа",
"type": "string",
"required": false
}
],
"states": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
},
"id": "f804ff3d-b2fc-11e6-8a84-bae500000065",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"name": "OMG",
"color": 10066329,
"stateType": "Regular",
"entityType": "internalorder"
}
],
"createShared": false
}
Отдельное доп. поле
Отдельное доп. поле
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Доп. поля. |
Запрос на получение информации по отдельному дополнительному полю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/attributes/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельного доп. поля.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/attributes/68d142e7-b300-11e6-8a84-bae50000008b",
"type": "attributemetadata",
"mediaType": "application/json"
},
"id": "68d142e7-b300-11e6-8a84-bae50000008b",
"name": "Доп поле внут заказа",
"type": "string",
"required": false
}
Внутренний заказ
Получить внутренний заказ
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id внутреннего заказа. |
Запрос на получение отдельного внутреннего заказа с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление внутреннего заказа.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
},
"id": "31d58bde-b2fd-11e6-8a84-bae500000068",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": false,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 13:52:01",
"name": "00002",
"description": "Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411hS2",
"moment": "2016-11-25 13:50:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"sum": 0,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/31d58bde-b2fd-11e6-8a84-bae500000068/positions",
"type": "internalorderposition",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-11-30 13:50:00",
"moves": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/3aa6f577-b2ff-11e6-8a84-bae500000070",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/3fe38e12-b2ff-11e6-8a84-bae500000077",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
}
}
],
"purchaseOrders": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/4a29b74e-b2ff-11e6-8a84-bae500000084",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/45353c47-b2ff-11e6-8a84-bae50000007e",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/purchaseorder/metadata",
"type": "purchaseorder",
"mediaType": "application/json"
}
}
]
}
Изменить внутренний заказ
Запрос на обновление внутреннего заказа с указанным id.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id внутреннего заказа. |
Пример запроса на обновление отдельного внутреннего заказа.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"name": "700222",
"description": "Мой обновлённый Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 1
},
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"positions": [
{
"quantity": 1,
"price": 2230,
"discount": 0,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
],
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-12-30 13:52:00"
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённого внутреннего заказа.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata",
"type": "internalorder",
"mediaType": "application/json"
},
"id": "64e426af-b0d8-11e6-8a84-bae500000064",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"owner": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/b905bfb0-9128-11e6-8a84-bae50000002a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
},
"shared": true,
"group": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/group/b8ba0d3f-9128-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/group/metadata",
"type": "group",
"mediaType": "application/json"
}
},
"updated": "2016-11-25 14:48:02",
"name": "700222",
"description": "Мой обновлённый Комментарий",
"externalCode": "00KNqzWbjDRhZ1A0411ss1231hS2",
"moment": "2016-11-25 13:52:00",
"applicable": true,
"rate": {
"currency": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/currency/b942e6f2-9128-11e6-8a84-bae500000058",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/currency/metadata",
"type": "currency",
"mediaType": "application/json"
}
},
"value": 63.45
},
"sum": 2230,
"store": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/b942743c-9128-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
}
},
"project": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/project/6c6dd3f9-97a1-11e6-8a84-bae500000002",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/project/metadata",
"type": "project",
"mediaType": "application/json"
}
},
"organization": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/organization/b9324d71-9128-11e6-8a84-bae500000051",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/organization/metadata",
"type": "organization",
"mediaType": "application/json"
}
},
"state": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/metadata/states/f804ff3d-b2fc-11e6-8a84-bae500000065",
"type": "state",
"mediaType": "application/json"
}
},
"created": "2007-02-07 17:16:41",
"positions": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions",
"type": "internalorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
}
},
"vatEnabled": true,
"vatIncluded": true,
"vatSum": 0,
"deliveryPlannedMoment": "2016-12-30 13:52:00",
"moves": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/move/a3b68a79-b0dc-11e6-8a84-bae5000000cd",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/move/metadata",
"type": "move",
"mediaType": "application/json"
}
}
]
}
Позиции внутреннего заказа
Отдельный ресурс для управления позициями внутреннего заказа. С его помощью вы можете управлять позициями большого документа, количество строк в котором превышает 100. Более подробно о лимитах на количество строк документа и работе с большими документами можно прочитать тут.
Получить позиции внутреннего заказа
Запрос на получение списка всех позиций данного внутреннего заказа. - meta Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой позиции внутреннего заказа.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id внутреннего заказа. |
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| search | string (optional) Example: 0001 URL Параметр для поиска по имени документа. Фильтр документов по указанной поисковой строке. Фильтрация происходит по полю name. |
Получить позиции внутреннего заказа
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка позиций отдельного внутреннего заказа.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions",
"type": "internalorderposition",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions/05379d42-b305-11e6-8a84-bae500000008",
"type": "internalorderposition",
"mediaType": "application/json"
},
"id": "05379d42-b305-11e6-8a84-bae500000008",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 1,
"price": 2230,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
}
Создать позиции внутреннего заказа
Запрос на создание новой позиции во внутреннем заказе. Для успешного создания необходимо в теле запроса указать следующие поля: + assortment - Ссылка на товар/услугу/серию/модификацию, которую представляет собой позиция. Также можно указать поле с именем service, consignment, variant в соответствии с тем, чем является указанная позиция. Подробнее об этом поле можно прочитать в описании позиции внутреннего заказа + quantity - Количество указанной позиции. Должно быть положительным, иначе возникнет ошибка. Одновременно можно создать как одну так и несколько позиций внутреннего заказа. Все созданные данным запросом позиции будут добавлены к уже существующим.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id внутреннего заказа. |
Пример создания позиций во внутреннем заказе.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '[
{
"quantity": 1,
"price": 100,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 12,
"price": 200,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"quantity": 3,
"price": 2230,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]'
Response 200 (application/json) Успешный запрос. Результат - JSON представление созданной позиции отдельного внутреннего заказа.
[
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions/705ff11b-b305-11e6-8a84-bae50000000c",
"type": "internalorderposition",
"mediaType": "application/json"
},
"id": "705ff11b-b305-11e6-8a84-bae50000000c",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 1,
"price": 100,
"vat": 10,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions/705ffca0-b305-11e6-8a84-bae50000000d",
"type": "internalorderposition",
"mediaType": "application/json"
},
"id": "705ffca0-b305-11e6-8a84-bae50000000d",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 12,
"price": 200,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions/706006cd-b305-11e6-8a84-bae50000000e",
"type": "internalorderposition",
"mediaType": "application/json"
},
"id": "706006cd-b305-11e6-8a84-bae50000000e",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 3,
"price": 2230,
"vat": 0,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
]
Удалить позицию внутреннего заказа
Параметры
| Параметр | Описание |
|---|---|
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции внутреннего заказа. |
Запрос на удаление позиции внутреннего заказа с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление позиции внутреннего заказа.
Позиция внутреннего заказа
Получить позицию
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id внутреннего заказа. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции внутреннего заказа. |
Запрос на получение отдельной позиции внутреннего заказа с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отдельной позиции внутреннего заказа.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions/705ffca0-b305-11e6-8a84-bae50000000d",
"type": "internalorderposition",
"mediaType": "application/json"
},
"id": "705ffca0-b305-11e6-8a84-bae50000000d",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 12,
"price": 200,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Изменить позицию
Запрос на обновление отдельной позиции внутреннего заказа.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id внутреннего заказа. |
| positionID | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id позиции внутреннего заказа. |
Пример запроса на обновление отдельной позиции во внутреннем заказе.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/entity/internalorder/7944ef04-f831-11e5-7a69-971500188b19/positions/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"quantity": 2,
"price": 500,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление обновлённой позиции заказа.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/internalorder/64e426af-b0d8-11e6-8a84-bae500000064/positions/705ffca0-b305-11e6-8a84-bae50000000d",
"type": "internalorderposition",
"mediaType": "application/json"
},
"id": "705ffca0-b305-11e6-8a84-bae50000000d",
"accountId": "b8b74698-9128-11e6-8a84-bae500000001",
"quantity": 2,
"price": 500,
"vat": 18,
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/f4ac4460-acf7-11e6-8a84-bae500000068",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
}
}
}
Group RPC Пересчёт расчётного остатка в инвентаризации
С помощью json api можно пересчитать расчётный остатки в позициях документа "Инвентаризация". В результате, значение поля calculatedQuantity у позиций инвентаризации изменится и документ будет пересохранён.
Пересчёт расчётного остатка в инвентаризации
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id инвентаризации. |
Пересчитать
Отправить запрос на пересчёт расчётных остатков у позиций инвентаризации.
Пример запроса (с пустым телом) на пересчёт расчётных остатков у позиций инвентаризации.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/rpc/inventory/7944ef04-f831-11e5-7a69-971500188b19/recalcCalculatedQuantity"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d ''
Response 201 (application/json) Успешный запрос. Результат - Пустое тело ответа.
Отчёты
Отчёт Остатки
Средствами JSON API можно запросить отчёт "Остатки" по всем товарам, по складам и по операциям. Больше об Остатках и работе с ними в основном интерфейсе вы можете прочитать в нашей службе поддержки по по этой ссылке.
Доступ к отчету Остатки
Для доступа к отчёту Остатки через API каких-либо дополнительных прав не требуется. На отображение товаров в отчёте Остатки влияют настройки видимости товаров и складов для пользователя, под именем которого запрашивается отчёт Остатки. Себестоимость, цена закупки, прибыль отображаются в Остатках при наличии у пользователя права <Видеть себестоимость, цену закупки и прибыль товаров>.
Отдельно для остатков по документу:
Для доступа к отчёту Остатки по документу через API каких-либо дополнительных прав не требуется, кроме наличия доступа пользователя к документу, по которому запрашиваются остатки. Себестоимость, цена закупки, прибыль отображаются в Остатках при наличии у пользователя права <Видеть себестоимость, цену закупки и прибыль товаров>.
Все Остатки
Отчёт "Все Остатки" представляет собой выдачу из объектов, каждый из которых показывает Остаток по каждому из товаров.
Атрибуты объекта отчёта:
- meta - Метаданные, представляющие собой ссылку на товар, модификацию или серию, по которой выдаётся Остаток
- stock - Остаток
- inTransit - Ожидание
- reserve - Резерв
- quantity - Доступно
- name - Наименование
- code - Код
- article - Артикул (если имеется)
- price - Себестоимость
- salePrice - Цена продажи
- uom - Единица измерения
- meta - Метаданные единицы измерений
- name - Наименование единицы измерений
- folder - Ссылка на группу товара/модификации/серии
- meta - Метаданные группы товара
- name - Наименование группы
- pathName - Наименование родительской группы
- image - Ссылка на изображение товара/модификации/серии
- externalCode - Внешний код сущности, по которой выводится остаток
Получить Остатки
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| store.id | string (optional) id склада, по которому нужно произвести фильтрацию. |
| product.id | string Параметр для фильтрации по нескольким id товаров. Пару параметр-значение применительно к этому параметру можно указывать несколько раз. Значение параметра - id товара, который должен быть включен в выборку. В результате применения данного фильтра в отфильтрованную выборку попадут только те товары, id которых были перечислены в этом параметре. Данный параметр фильтрации можно комбинировать с параметрами consignment.id и variant.id Если в массиве UUID будет передан только 1 товар, то в итоговую выборку попадут только остатки по 1 товару. Примеры параметра фильтрации:- product.id=656c4032-8552-11e6-8a84-bae500000044&product.id=706b9cd3-8552-11e6-8a84-bae500000045&product.id=7a5f0ed5-8552-11e6-8a84-bae500000046 - consignment.id=656c4032-8552-11e6-8a84-bae500000044&consignment.id=706b9cd3-8552-11e6-8a84-bae500000045&product.id=7a5f0ed5-8552-11e6-8a84-bae500000046- variant.id=656c4032-8552-11e6-8a84-bae500000044&consignment.id=706b9cd3-8552-11e6-8a84-bae500000045&product.id=7a5f0ed5-8552-11e6-8a84-bae500000046 |
| consignment.id | string (optional) Параметр для фильтрации по нескольким id серий.Пару параметр-значение применительно к этому параметру можно указывать несколько раз. Значение параметра - id серии, которая должна быть включена в выборку. В результате применения данного фильтра в отфильтрованную выборку попадут только те серии, id которых были перечислены в этом параметре. Данный параметр фильтрации можно комбинировать с параметрами product.id и variant.id Примеры параметра фильтрации: - consignment.id=656c4032-8552-11e6-8a84-bae500000044&consignment.id=706b9cd3-8552-11e6-8a84-bae500000045&consignment.id=7a5f0ed5-8552-11e6-8a84-bae500000046 - consignment.id=656c4032-8552-11e6-8a84-bae500000044&consignment.id=706b9cd3-8552-11e6-8a84-bae500000045&product.id=7a5f0ed5-8552-11e6-8a84-bae500000046- variant.id=656c4032-8552-11e6-8a84-bae500000044&variant.id=706b9cd3-8552-11e6-8a84-bae500000045&consignment.id=7a5f0ed5-8552-11e6-8a84-bae500000046 - variant.id=656c4032-8552-11e6-8a84-bae500000044&consignment.id=706b9cd3-8552-11e6-8a84-bae500000045&product.id=7a5f0ed5-8552-11e6-8a84-bae500000046 |
| variant.id | string (optional) Параметр для фильтрации по нескольким id модификаций. Пару параметр-значение применительно к этому параметру можно указывать несколько раз. Значение параметра - id модификации, которая должна быть включена в выборку. В результате применения данного фильтра в отфильтрованную выборку попадут только те модификации, id которых были перечислены в этом параметре. Данный параметр фильтрации можно комбинировать с параметрами product.id и consignment.id Примеры параметра фильтрации:- variant.id=656c4032-8552-11e6-8a84-bae500000044&variant.id=706b9cd3-8552-11e6-8a84-bae500000045 - variant.id=656c4032-8552-11e6-8a84-bae500000044&variant.id=706b9cd3-8552-11e6-8a84-bae500000045&consignment.id=7a5f0ed5-8552-11e6-8a84-bae500000046 - variant.id=656c4032-8552-11e6-8a84-bae500000044&consignment.id=706b9cd3-8552-11e6-8a84-bae500000045&product.id=7a5f0ed5-8552-11e6-8a84-bae500000046 |
| productFolder.id | string (optional) id группы товаров, по которой нужно произвести фильтрацию. |
| search | string (optional) Фильтр товаров и услуг по указанной поисковой строке. Фильтрация происходит по наименованию товаров и услуг. |
| stockMode | string (optional) Default: nonEmpty Вид Остатка. |
| groupBy | string (optional) тип, по которому нужно сгруппировать выдачу.По умолчанию параметр groupBy имеет значение variant. Если вы хотите увидеть объекты типа consignment, или только объекты типа product, необходимо выставить соответствующее значение параметра.
|
| moment | string (optional) Момент времени, на который нужно вывести остатки. Передаётся в виде строки в формате ГГГГ-ММ-ДД ЧЧ-ММ-СС |
| characteristics | string (optional) id склада, по которому нужно произвести фильтрацию. Фильтрация по имени и значению характеристик. Доступна только если используется группировка по модификациям (groupBy=variant). Параметры передаются в виде characteristics.<имя_атрибута>=<значение атрибута>. Возможна фильтрация по нескольким характеристикам. Для этого нужно передать несколько параметров аналогичных данному, с различными именами характеристик. Пример:
|
| includeRelated | boolean (optional) Вывод остатков по модификациям и сериям товаров. Параметр позволяет включить в выборку остатки по модификациям и сериям для товаров. Необходимым условием для применения параметра является обязательное наличие фильтрации по товарам или модификациям или их комбинации. При выбранном значении includeRelated=true будут включены все остатки для товаров, модификаций и серий, указанных в параметрах фильтрации.При использовании параметра устанавливается параметр группировки groupBy=consignment, переданные значения для groupBy будут проигнорированы. |
Запрос на получение отчёта "Все Остатки".
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/stock/all"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отчёта.
{
"context": {
"employee": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/stock/all",
"type": "stock",
"mediaType": "application/json",
"size": 26,
"limit": 10,
"offset": 0,
"nextHref": "http://online.moysklad.ru/api/remap/1.2/report/stock/all?limit=10&offset=10"
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stock": -30,
"inTransit": 0,
"reserve": 0,
"quantity": -30,
"name": "Товар",
"code": "one1",
"article": "Ar23",
"price": 0,
"salePrice": 346347237000,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/cc99c055-fa34-11e5-9464-e4de00000069?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stock": 4,
"inTransit": 0,
"reserve": 0,
"quantity": 4,
"name": "ТоварБезШК",
"code": "00006",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8f5f9ff-fa34-11e5-9464-e4de0000008a?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stock": 1,
"inTransit": 0,
"reserve": 0,
"quantity": 1,
"name": "Товар с модой без ШК",
"code": "00008",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/e8f9d714-fa34-11e5-9464-e4de0000008d?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stock": 1,
"inTransit": 0,
"reserve": 0,
"quantity": 1,
"name": "Товар с модой без ШК (1)",
"code": "00208",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/e8fc24b5-fa34-11e5-9464-e4de00000091?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stock": 1,
"inTransit": 0,
"reserve": 0,
"quantity": 1,
"name": "Товар с модой без ШК (2)",
"code": "00209",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/e91042b4-fa34-11e5-9464-e4de00000095?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stock": 1,
"inTransit": 0,
"reserve": 0,
"quantity": 1,
"name": "Товар с модой без ШК (3)",
"code": "00210",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/daf1186d-fa34-11e5-9464-e4de0000006f?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stock": 1,
"inTransit": 0,
"reserve": 0,
"quantity": 1,
"name": "ТоварСМодой_и_ШК",
"code": "00007",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/db1a888a-fa34-11e5-9464-e4de00000073?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stock": 1,
"inTransit": 0,
"reserve": 0,
"quantity": 1,
"name": "ТоварСМодой_и_ШК (1)",
"code": "00205",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/db2066c8-fa34-11e5-9464-e4de00000077?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stock": 1,
"inTransit": 0,
"reserve": 0,
"quantity": 1,
"name": "ТоварСМодой_и_ШК (2)",
"code": "00206",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/db22f3e8-fa34-11e5-9464-e4de0000007b?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stock": 1,
"inTransit": 0,
"reserve": 0,
"quantity": 1,
"name": "ТоварСМодой_и_ШК (3)",
"code": "00207",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/d3e2dcd6-f648-11e5-8a84-bae500000074?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stock": -6438,
"inTransit": 0,
"reserve": 0,
"quantity": -6438,
"name": "ТоварСоСтраной",
"code": "00002",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/eeef177f-f648-11e5-8a84-bae50000007a?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stock": -113,
"inTransit": 0,
"reserve": 0,
"quantity": -113,
"name": "Мяч",
"code": "00003",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/fd867506-f67d-11e5-8a84-bae50000006e?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stock": -21,
"inTransit": 0,
"reserve": 0,
"quantity": -21,
"name": "Мяч (Футбольный)",
"code": "00002",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/fd92dbb9-f67d-11e5-8a84-bae500000076?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stock": -1,
"inTransit": 0,
"reserve": 0,
"quantity": -1,
"name": "Мяч (Волейбольный)",
"code": "00004",
"price": 0,
"salePrice": 0,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/be903062-f504-11e5-8a84-bae50000019a?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stock": 69,
"inTransit": 0,
"reserve": 20,
"quantity": 49,
"name": "Трололоша",
"code": "00001",
"price": 50260.86956521739,
"salePrice": 123000,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/d1bef0a1-ffe7-11e5-9464-e4de0000001c?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stock": -1,
"inTransit": 0,
"reserve": 0,
"quantity": -1,
"name": "ТОварИщ (10)",
"code": "00214",
"article": "Артикулс",
"price": 0,
"salePrice": 346347237000,
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/c6bc9273-2c83-11e6-8a84-bae5000000a3",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
},
"folder": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/productfolder/0c78adde-ffe3-11e5-9464-e4de000000a2",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/productFolder/metadata",
"type": "productfolder",
"mediaType": "application/json"
},
"name": "Товары Из кастомной группы",
"pathName": "Группа"
},
"image": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/e2ba4863-ffed-11e5-9464-e4de00000034",
"mediaType": "application/octet-stream"
},
"updated": "2017-01-11 14:54:10",
"size": 0,
"miniature": {
"href": "https://online.moysklad.ru/api/remap/1.2/download/e2ba4863-ffed-11e5-9464-e4de00000034?miniature=true",
"mediaType": "image/png"
},
"tiny": {
"href": "https://online.moysklad.ru/app/download/e2ba38fd-ffed-11e5-9464-e4de00000033.png",
"mediaType": "image/png"
}
},
"externalCode": "ibWbdtWWhXiIwfZVEal6z2"
}
]
}
Остатки по складам
Отчёт "Остатки по складам" представляет собой массив объектов, каждый из которых показывает Остаток по каждому из товаров на каждом из складов.
Атрибуты объекта отчёта:
- meta - Метаданные, представляющие собой ссылку на позицию, по которой выдаётся Остаток
- stockByStore - Объект, представляющие собой Остатки по складам (описание ниже).
Остатки по складам
Поле "Остатки по складам" (stockByStore) представляет собой выдачу из объектов со следующими атрибутами: + meta - Метаданные, представляющие собой ссылку на склад, по которому выводится Остаток + name - Наименование склада + stock - Остаток + reserve - Резерв + inTransit - Ожидание
Размерность этого поля всегда равна количеству складов в системе.
Получить Остатки по складам
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| product.id | string (optional) id товара по которому нужно произвести фильтрацию. |
| productFolder.id | string (optional) id группы товаров, по которой нужно произвести фильтрацию. |
| search | string (optional) Фильтр товаров и услуг по указанной поисковой строке. Фильтрация происходит по наименованию товаров и услуг. |
| stockMode | string (optional) Default: nonEmpty Вид Остатка. |
| groupBy | string (optional) тип, по которому нужно сгруппировать выдачу.По умолчанию параметр groupBy имеет значение variant. Если вы хотите увидеть объекты типа consignment, или только объекты типа product, необходимо выставить соответствующее значение параметра.
|
Запрос на получение отчёта "Остатки по складам".
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/stock/bystore"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отчёта.
{
"context": {
"employee": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"type": "employee",
"mediaType": "application/json"
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/stock/bystore",
"type": "stockbystore",
"mediaType": "application/json",
"size": 225,
"limit": 1000,
"offset": 0,
"nextHref": "http://online.moysklad.ru/api/remap/1.2/report/stock/bystore?limit=25&offset=25"
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/c02e3a5c-007e-11e6-9464-e4de00000006?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stockByStore": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Не основной склад",
"stock": -30,
"reserve": 0,
"inTransit": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Основной склад",
"stock": 0,
"reserve": 0,
"inTransit": 0
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/cc99c055-fa34-11e5-9464-e4de00000069?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stockByStore": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Не основной склад",
"stock": 0,
"reserve": 0,
"inTransit": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Основной склад",
"stock": 4,
"reserve": 0,
"inTransit": 0
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/e8f5f9ff-fa34-11e5-9464-e4de0000008a?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stockByStore": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Не основной склад",
"stock": 0,
"reserve": 0,
"inTransit": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Основной склад",
"stock": 1,
"reserve": 0,
"inTransit": 0
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/e8f9d714-fa34-11e5-9464-e4de0000008d?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stockByStore": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Не основной склад",
"stock": 0,
"reserve": 0,
"inTransit": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Основной склад",
"stock": 1,
"reserve": 0,
"inTransit": 0
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/e8fc24b5-fa34-11e5-9464-e4de00000091?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stockByStore": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Не основной склад",
"stock": 0,
"reserve": 0,
"inTransit": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Основной склад",
"stock": 1,
"reserve": 0,
"inTransit": 0
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/e91042b4-fa34-11e5-9464-e4de00000095?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"stockByStore": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Не основной склад",
"stock": 0,
"reserve": 0,
"inTransit": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Основной склад",
"stock": 1,
"reserve": 0,
"inTransit": 0
}
]
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/daf1186d-fa34-11e5-9464-e4de0000006f?expand=supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"stockByStore": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/86c857d6-0302-11e6-9464-e4de00000072",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Не основной склад",
"stock": 0,
"reserve": 0,
"inTransit": 0
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/store/850ee995-f504-11e5-8a84-bae500000160",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/store/metadata",
"type": "store",
"mediaType": "application/json"
},
"name": "Основной склад",
"stock": 1,
"reserve": 0,
"inTransit": 0
}
]
}
]
}
Отчёт Прибыльность
Средствами JSON API можно запросить отчёт "Прибыльность" по всем товарам, услугам, модификациям, сотрудникам и покупателям. О том, что представляет собой отчёт "Прибыльность" вы можете прочитать по этой ссылке.
Прибыльность по товарам
Атрибуты объекта отчёта:
- assortment- Краткое представление товара или услуги в отчёте (структура ниже)
- sellQuantity - Проданное количество
- sellPrice - Цена продаж (средняя)
- sellCost - Себестоимость
- sellSum - Сумма продаж
- sellCostSum - Сумма себестоимостей продаж
- returnQuantity - Количество возвратов
- returnPrice - Цена возвратов
- returnCost - Себестоимость возвратов
- returnSum - Сумма возвратов
- returnCostSum - Сумма себестоимостей возвратов
- profit - Прибыль
- margin - Рентабельность
Структура объекта assortment
- meta - Метаданные, представляющие собой ссылку на товар или услугу
- name - Наименование товара или услуги
- code - Код товара или услуги
- uom - Единица измерения
- article - Артикул товара
- image - Изображение товара
Получить Прибыльность по товарам
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение отчёта "Прибыльность по товарам".
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/sales/byproduct"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отчёта.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/sales/byproduct",
"type": "salesbyproduct",
"mediaType": "application/json",
"size": 5,
"limit": 2,
"offset": 0,
"nextHref": "https://online.moysklad.ru/api/remap/1.2/report/sales/byproduct?limit=2&offset=2"
},
"rows": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/6af0f1c9-4814-11e6-8a84-bae5000006b4",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"name": "Курево",
"code": "00067",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
}
},
"sellQuantity": 8643,
"sellPrice": 216174.97396737244,
"sellCost": 0,
"sellSum": 1868400300,
"sellCostSum": 0,
"returnQuantity": 0,
"returnPrice": 0,
"returnCost": 0,
"returnSum": 0,
"returnCostSum": 0,
"profit": 1868400300,
"margin": 0
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/6a9bdfe4-4814-11e6-8a84-bae500000503",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json"
},
"name": "Ногтеточка",
"code": "00198",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
}
},
"sellQuantity": 4765,
"sellPrice": 100000000,
"sellCost": 0,
"sellSum": 476500000000,
"sellCostSum": 0,
"returnQuantity": 0,
"returnPrice": 0,
"returnCost": 0,
"returnSum": 0,
"returnCostSum": 0,
"profit": 476500000000,
"margin": 0
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/3413f2dd-484e-11e8-6a80-332a00000091",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=3412d794-484e-11e8-6a80-332a0000008f"
},
"name": "Заточка коньков",
"code": "00045",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
}
},
"sellQuantity": 10,
"sellPrice": 500000,
"sellCost": 300000,
"sellSum": 5000000,
"sellCostSum": 3000000,
"returnQuantity": 3,
"returnPrice": 500000,
"returnCost": 300000,
"returnSum": 1500000,
"returnCostSum": 900000,
"profit": 1400000,
"margin": 0.6666666666666666
}
]
}
Прибыльность по модификациям
Атрибуты объекта отчёта:
- assortment- Краткое представление модификации, услуги или комплекта в отчёте (структура ниже)
- sellQuantity - Проданное количество
- sellPrice - Цена продаж (средняя)
- sellCost - Себестоимость
- sellSum - Сумма продаж
- sellCostSum - Сумма себестоимостей продаж
- returnQuantity - Количество возвратов
- returnPrice - Цена возвратов
- returnCost - Себестоимость возвратов
- returnSum - Сумма возвратов
- returnCostSum - Сумма себестоимостей возвратов
- profit - Прибыль
- margin - Рентабельность
Структура объекта assortment
- meta - Метаданные, представляющие собой ссылку на модификацию, услугу или комплект
- name - Наименование сущности
- code - Код сущности
- article - Артикул модификации или комплекта
- image - Изображение модификации
Получить Прибыльность по модификациям
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение отчёта "Прибыльность по модификациям".
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/sales/byvariant"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отчёта.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/sales/byvariant",
"type": "salesbyvariant",
"mediaType": "application/json",
"size": 5,
"limit": 2,
"offset": 0,
"nextHref": "https://online.moysklad.ru/api/remap/1.2/report/sales/byvariant?limit=2&offset=2"
},
"rows": [
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/6af0f1c9-4814-11e6-8a84-bae5000006b4?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"name": "Курево (Африка, 0.2, Комбайны)",
"code": "00067",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
}
},
"sellQuantity": 8643,
"sellPrice": 216174.97396737244,
"sellCost": 0,
"sellSum": 1868400300,
"sellCostSum": 0,
"returnQuantity": 0,
"returnPrice": 0,
"returnCost": 0,
"returnSum": 0,
"returnCostSum": 0,
"profit": 1868400300,
"margin": 0
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/variant/6a9bdfe4-4814-11e6-8a84-bae500000503?expand=product.supplier",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/variant/metadata",
"type": "variant",
"mediaType": "application/json"
},
"name": "Ногтеточка (Белый, 20, Нет, 1000)",
"code": "00198",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
}
},
"sellQuantity": 4765,
"sellPrice": 100000000,
"sellCost": 0,
"sellSum": 476500000000,
"sellCostSum": 0,
"returnQuantity": 0,
"returnPrice": 0,
"returnCost": 0,
"returnSum": 0,
"returnCostSum": 0,
"profit": 476500000000,
"margin": 0
},
{
"assortment": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/service/3413f2dd-484e-11e8-6a80-332a00000091",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/service/metadata",
"type": "service",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=3412d794-484e-11e8-6a80-332a0000008f"
},
"name": "Заточка коньков",
"code": "00045",
"uom": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/uom/19f1edc0-fc42-4001-94cb-c9ec9c62ec10",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/uom/metadata",
"type": "uom",
"mediaType": "application/json"
},
"name": "шт"
}
},
"sellQuantity": 10,
"sellPrice": 500000,
"sellCost": 300000,
"sellSum": 5000000,
"sellCostSum": 3000000,
"returnQuantity": 3,
"returnPrice": 500000,
"returnCost": 300000,
"returnSum": 1500000,
"returnCostSum": 900000,
"profit": 1400000,
"margin": 0.6666666666666666
}
]
}
Прибыльность по сотрудникам
Атрибуты объекта отчёта:
- employee- Краткое представление сотрудника в отчёте (структура ниже)
- salesCount - Количество продаж
- salesAvgCheck - Средний чек продаж
- sellSum - Сумма продаж
- sellCostSum - Сумма себестоимостей продаж
- returnCount - Количество возвратов
- returnAvgCheck - Средний чек возврата
- returnSum - Сумма возвратов
- returnCostSum - Сумма себестоимостей возвратов
- profit - Прибыль
- margin - Рентабельность
Структура объекта employee
- meta - Метаданные, представляющие собой ссылку на сотрудника
- name - Имя сотрудника
Получить Прибыльность по сотрудникам
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение отчёта "Прибыльность по сотрудникам".
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/sales/byemployee"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отчёта.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/sales/byEmployee",
"type": "salesbyemployee",
"mediaType": "application/json",
"size": 1,
"limit": 1000,
"offset": 0
},
"rows": [
{
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/employee/3c9ef5be-4814-11e6-8a84-bae500000028",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
},
"name": "Администратор"
},
"salesCount": 3,
"salesAvgCheck": 104498369718788910,
"sellSum": 313495109156366700,
"sellCostSum": 0,
"returnCount": 0,
"returnAvgCheck": 0,
"returnSum": 0,
"returnCostSum": 0,
"profit": 313495109156366700,
"margin": 0
}
]
}
Прибыльность по покупателям
Атрибуты объекта отчёта:
- counterparty- Краткое представление покупателя в отчёте (структура ниже)
- salesCount - Количество продаж
- salesAvgCheck - Средний чек продаж
- sellSum - Сумма продаж
- sellCostSum - Сумма себестоимостей продаж
- returnCount - Количество возвратов
- returnAvgCheck - Средний чек возврата
- returnSum - Сумма возвратов
- returnCostSum - Сумма себестоимостей возвратов
- profit - Прибыль
- margin - Рентабельность
Структура объекта counterparty
- meta - Метаданные, представляющие собой ссылку на покупателя
- name - Имя покупателя
Получить Прибыльность по покупателям
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение отчёта "Прибыльность по покупателям".
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/sales/bycounterparty"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отчёта.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/sales/bycounterparty",
"type": "salesbyCounterparty",
"mediaType": "application/json",
"size": 3,
"limit": 1,
"offset": 0,
"nextHref": "https://online.moysklad.ru/api/remap/1.2/report/sales/bycounterparty?limit=1&offset=1"
},
"rows": [
{
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/3cd88c00-4814-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"name": "ООО \"Покупатель\""
},
"salesCount": 1,
"salesAvgCheck": 310390615323104640,
"sellSum": 310390615323104640,
"sellCostSum": 0,
"returnCount": 0,
"returnAvgCheck": 0,
"returnSum": 0,
"returnCostSum": 0,
"profit": 310390615323104640,
"margin": 0
}
]
}
Отчёт Показатели контрагентов
Средствами JSON API можно запросить отчёт "Показатели контрагентов" по всем или по отдельному контрагенту. О том, что представляет собой отчёт "Показатели контрагентов" вы можете прочитать по этой ссылке.
Показатели контрагентов
Атрибуты показателей
- meta - Метаданные отчёта по данному контрагенту
- counterparty - Контрагент
- meta - Метаданные контрагента
- id - id контрагента
- name - Имя контрагента
- externalCode - Внешний код контрагента
- companyType - Тип контрагента
- firstDemandDate - Дата первой продажи
- lastDemandDate - Дата последней продажи
- demandsCount - Количество продаж
- demandsSum - Сумма продаж
- averageReceipt - Средний чек
- returnsCount - Количество возвратов
- returnsSum - Сумма возвратов
- discountsSum - Сумма скидок
- balance - Баланс
- profit - Прибыль
- lastEventDate - Дата последнего события
- lastEventText - Текст последнего события
- updated - Момент последнего изменения контрагента
Атрибуты доступные для фильтрации
- id - id контрагента
- counterparty.name - Имя контрагента
- counterparty.phone - Номер телефона
- counterparty.email - Адрес электронной почты
- counterparty.inn - Тип контрагента
- counterparty.companyType - Тип контрагента
- counterparty.description - Комментарий к Контрагенту
- firstDemandDate - Дата первой продажи
- lastDemandDate - Дата последней продажи
- demandsCount - Количество продаж
- demandsSum - Сумма продаж
- averageReceipt - Средний чек
- returnsCount - Количество возвратов
- returnsSum - Сумма возвратов
- discountsSum - Сумма скидок
- balance - Баланс
- profit - Прибыль
- lastEventDate - Дата последнего события
- lastEventText - Текст последнего события
- updated - Момент последнего изменения контрагента
Тарифные ограничения
Если в вашем тарифе не предусмотрена опция CRM вы не сможете получить этот запрос через API.
Показатели контрагентов
Запрос на получение отчёта по контрагентам. Результат успешного запроса - JSON представление списка отчётов по отдельным котрагентам: - meta Метаданные отчёта, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой отчёты по отдельным контрагентам.
Запрос на получение отчёта по контрагентам.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/counterparty"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отчёта по контрагентам.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty",
"type": "counterparty",
"mediaType": "application/json",
"size": 5,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty/b80ea81b-7058-11e6-8a84-bae500000000",
"type": "counterparty",
"mediaType": "application/json"
},
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/b80ea81b-7058-11e6-8a84-bae500000000",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "b80ea81b-7058-11e6-8a84-bae500000000",
"name": "ООО Радуга",
"externalCode": "o7732zkki541HDkZZD1Yt3",
"companyType": "legal"
},
"firstDemandDate": null,
"lastDemandDate": null,
"demandsCount": 0,
"demandsSum": 0,
"averageReceipt": 0,
"returnsCount": 0,
"returnsSum": 0,
"discountsSum": 0,
"balance": 0,
"profit": 0,
"lastEventDate": null,
"lastEventText": null,
"updated": "2016-09-01 18:32:17"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty/df2fdd2d-6934-11e6-8a84-bae500000049",
"type": "counterparty",
"mediaType": "application/json"
},
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/df2fdd2d-6934-11e6-8a84-bae500000049",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "df2fdd2d-6934-11e6-8a84-bae500000049",
"name": "rtr",
"externalCode": "rRlzrdZmjql9r9dveXPE43",
"companyType": "legal"
},
"firstDemandDate": null,
"lastDemandDate": null,
"demandsCount": 0,
"demandsSum": 0,
"averageReceipt": 0,
"returnsCount": 0,
"returnsSum": 0,
"discountsSum": 0,
"balance": 0,
"profit": 0,
"lastEventDate": "2016-09-08 13:07:30",
"lastEventText": "продажа",
"updated": "2016-08-23 16:24:08"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty/12c9ebcf-692c-11e6-8a84-bae50000005d",
"type": "counterparty",
"mediaType": "application/json"
},
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12c9ebcf-692c-11e6-8a84-bae50000005d",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "12c9ebcf-692c-11e6-8a84-bae50000005d",
"name": "Розничный покупатель",
"externalCode": "lBvYwLWMiBsct7sVRrFnJ2",
"companyType": "legal"
},
"firstDemandDate": "2016-08-26 15:49:00",
"lastDemandDate": "2016-08-26 15:49:00",
"demandsCount": 1,
"demandsSum": 80000,
"averageReceipt": 80000,
"returnsCount": 0,
"returnsSum": 0,
"discountsSum": 0,
"balance": 0,
"profit": -103040600,
"lastEventDate": null,
"lastEventText": null,
"updated": "2016-08-23 15:21:09"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty/12a8e347-692c-11e6-8a84-bae500000055",
"type": "counterparty",
"mediaType": "application/json"
},
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8e347-692c-11e6-8a84-bae500000055",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "12a8e347-692c-11e6-8a84-bae500000055",
"name": "ООО \"Покупатель\"",
"externalCode": "DTItQRbDhyl472ZqC5OWw2",
"inn": "7736570902",
"companyType": "legal"
},
"firstDemandDate": "2016-09-01 17:54:00",
"lastDemandDate": "2016-09-01 17:54:00",
"demandsCount": 1,
"demandsSum": 60000,
"averageReceipt": 60000,
"returnsCount": 0,
"returnsSum": 0,
"discountsSum": 0,
"balance": 1241255000,
"profit": 50000,
"lastEventDate": null,
"lastEventText": null,
"updated": "2016-08-23 15:21:09"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty/12a8b923-692c-11e6-8a84-bae500000053",
"type": "counterparty",
"mediaType": "application/json"
},
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/12a8b923-692c-11e6-8a84-bae500000053",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "12a8b923-692c-11e6-8a84-bae500000053",
"name": "ООО \"Поставщик\"",
"externalCode": "aZBfWOKzj-lcq7c7IWZON3",
"inn": "7736570901",
"companyType": "legal"
},
"firstDemandDate": null,
"lastDemandDate": null,
"demandsCount": 0,
"demandsSum": 0,
"averageReceipt": 0,
"returnsCount": 0,
"returnsSum": 0,
"discountsSum": 0,
"balance": 0,
"profit": 0,
"lastEventDate": null,
"lastEventText": null,
"updated": "2016-08-23 15:21:09"
}
]
}
Выборочные показатели контрагентов
Запрос на получение отчёта по указанным контрагентам. Необходимо передать массив counterparties,
содержащий метаданные контрагентов, по которым требуются отчёты.
Результат успешного запроса - JSON представление списка отчётов по указанным котрагентам:
- meta Метаданные отчёта,
- context - Метаданные о сотруднике, выполнившем запрос.
- rows - Массив JSON объектов, представляющих собой отчёты по отдельным контрагентам.
Пример запроса отчётов для нескольких контрагентов.
curl -X POST
"https://online.moysklad.ru/api/remap/1.2/report/counterparty"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"counterparties": [
{
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/49b40d55-66cc-11e7-6adb-ede500000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
},
{
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/37e4efe0-6ade-11e7-6adb-ede50000001a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
}
}
}
]
}'
Response 200 (application/json) Успешный запрос. Результат - JSON представление отчёта по контрагентам.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty",
"type": "counterparty",
"mediaType": "application/json",
"size": 2,
"limit": 1000,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty/49b40d55-66cc-11e7-6adb-ede500000054",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=49b40d55-66cc-11e7-6adb-ede500000054"
},
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/49b40d55-66cc-11e7-6adb-ede500000054",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=49b40d55-66cc-11e7-6adb-ede500000054"
},
"id": "49b40d55-66cc-11e7-6adb-ede500000054",
"name": "ООО \"Поставщик\"",
"externalCode": "btkD664AiiIaIYMdI50OW3",
"inn": "7736570901",
"companyType": "legal"
},
"firstDemandDate": null,
"lastDemandDate": null,
"demandsCount": 0,
"demandsSum": 0,
"averageReceipt": 0,
"returnsCount": 0,
"returnsSum": 0,
"discountsSum": 0,
"balance": 0,
"profit": 0,
"lastEventDate": null,
"lastEventText": null,
"updated": "2017-07-12 09:35:26"
},
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty/37e4efe0-6ade-11e7-6adb-ede50000001a",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=37e4efe0-6ade-11e7-6adb-ede50000001a"
},
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/37e4efe0-6ade-11e7-6adb-ede50000001a",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#company/edit?id=37e4efe0-6ade-11e7-6adb-ede50000001a"
},
"id": "37e4efe0-6ade-11e7-6adb-ede50000001a",
"name": "ООО \"Поставщик 2\"",
"externalCode": "WG4JRabzgb6aW9asZ20yy3",
"inn": "7736570901",
"companyType": "legal"
},
"firstDemandDate": null,
"lastDemandDate": null,
"demandsCount": 0,
"demandsSum": 0,
"averageReceipt": 0,
"returnsCount": 0,
"returnsSum": 0,
"discountsSum": 0,
"balance": 0,
"profit": 0,
"lastEventDate": null,
"lastEventText": null,
"updated": "2017-07-17 13:54:30"
}
]
}
Показатели контрагента
Показатели контрагента
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Запрос на получение отчёта по контрагенту с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/counterparty/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление отчёта по контрагенту.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/report/counterparty/df2fdd2d-6934-11e6-8a84-bae500000049",
"type": "counterparty",
"mediaType": "application/json"
},
"counterparty": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/df2fdd2d-6934-11e6-8a84-bae500000049",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/counterparty/metadata",
"type": "counterparty",
"mediaType": "application/json"
},
"id": "df2fdd2d-6934-11e6-8a84-bae500000049",
"name": "rtr",
"externalCode": "rRlzrdZmjql9r9dveXPE43",
"companyType": "legal"
},
"firstDemandDate": "2016-09-01 17:54:00",
"lastDemandDate": "2016-09-01 17:54:00",
"demandsCount": 1,
"demandsSum": 60000,
"averageReceipt": 60000,
"returnsCount": 0,
"returnsSum": 0,
"discountsSum": 0,
"balance": -60000,
"profit": 50000,
"lastEventDate": "2016-09-08 13:07:30",
"lastEventText": "продажа",
"updated": "2016-08-23 16:24:08"
}
Показатели
В рамках JSON API можно запросить показатели за день, месяц и неделю. Подробнее о разделе "Показатели" вы можете прочитать на портале поддержки по этой ссылке.
Структура объекта показателей
- sales - Вложенный объект, представляющий собой информацию о продажах за указанный период
- count - Количество продаж
- amount - Прибыль
- movementAmount - Дельта по сравнению с прошлым аналогичным периодом
- orders - Вложенный объект, представляющий собой информацию о заказах за указанный период
- count - Количество заказов
- amount - Прибыль
- movementAmount - Дельта по сравнению с прошлым аналогичным периодом
- money - Вложенный объект, представляющий собой информацию о деньгах за указанный период
- income - Доходы за период
- outcome - Расходы за период
- balance - Текущий баланс
- todayMovement - Дельта за сегодня
- movement - Дельта за период
День
Получить показатели за день
Запрос на получение показателей за день.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/dashboard/day"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление показателей.
{
"sales": {
"count": 0,
"amount": 0,
"movementAmount": -80000
},
"orders": {
"count": 0,
"amount": 0,
"movementAmount": 0
},
"money": {
"income": 0,
"outcome": 0,
"balance": 69700,
"todayMovement": 0,
"movement": 0
}
}
Неделя
Получить показатели за неделю
Запрос на получение показателей за неделю.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/dasboard/week"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление показателей.
{
"sales": {
"count": 0,
"amount": 0,
"movementAmount": -80000
},
"orders": {
"count": 0,
"amount": 0,
"movementAmount": 0
},
"money": {
"income": 0,
"outcome": 0,
"balance": 69700,
"todayMovement": 0,
"movement": 0
}
}
Месяц
Получить показатели за месяц
Запрос на получение показателей за месяц.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/report/dashboard/month"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление показателей.
{
"sales": {
"count": 0,
"amount": 0,
"movementAmount": -80000
},
"orders": {
"count": 0,
"amount": 0,
"movementAmount": 0
},
"money": {
"income": 0,
"outcome": 0,
"balance": 69700,
"todayMovement": 0,
"movement": 0
}
}
Аудит
Аудит
Сервис МойСклад накапливает сведения о всех событиях в системе. Эта часть сервиса называется аудит, а накопленные сведения - событиями аудита. Изменения по конкретной сущности доступны пользователям при наличии прав на просмотр, подробная информация о всех изменениях доступна только пользователям с правами администратора.
Основными сущностями в аудите JSON API являются контексты и события. События содержат подробную информацию о произошедших изменениях конкретной сущности или операции, например, изменение значения поля. Контекстом называются одно или несколько связанных событий, например, массовое обновление товаров. События отражают конкретные произошедшие изменения, связанные с одной сущностью, контекст же содержит только общую информацию событий, относящихся к нему.
Пользователь может получить подробную информацию об изменениях в системе через JSON API двумя способами:
- Просмотр общей ленты аудита
Для просмотра общей ленты аудита через JSON API пользователь может запросить список контекстов, которые будут содержать общую информацию об изменениях, произошедших в системе, а также ссылку на связные с ними события. Для просмотра подробной информации по отдельному контексту, необходимо запросить события по конкретному контексту. В ответе пользователю будет содержаться детальная информация об изменениях сущности, произошедших в рамках данного обновления в системе, в специальном формате diff
- Просмотр событий по отдельной сущности
Для того, чтобы получить события, связанные с конкретной сущностью, необходимо воспользоваться запросом событий по сущности. Ответ будет содержать список событий, относящихся к данной сущности или операции, где в специальном поле diff будут отражены подробные изменения полей сущности или операции.
Контексты
В аудите под контекстом подразумевается одно или несколько связанных событий, например, массовое обновление товаров. События отражают конкретные произошедшие изменения, например, изменение значения поля. Контекст же содержит только общую информацию событий, относящихся к нему.
Атрибуты сущности
- meta - Метаданные сущности Контекста
Только для чтения - id - ID Контекста в формате UUID
Только для чтения - uid - Логин Сотрудника
Только для чтения - supportAccess - был ли доступ произведен поддержкой от имени пользователя. Флаг отсутствует, если значение false
Только для чтения - source - Тип изменения
Только для чтения - moment - Дата изменения
Только для чтения - objectCount - количество измененных объектов
Только для чтения - eventType - действие Событий (поле присутствует, только если оно одинаково у всех Событий в рамках данного Контекста)
Только для чтения - entityType - название сущности (поле присутствует, только если оно одинаково у всех Событий в рамках данного Контекста)
Только для чтения - objectType - тип сущностей, с которыми связанно данное изменение. Поле присутствует только для
entityType=entitysettingsилиstatesettingsилиtemplatesettings - info - Краткое описание, выводится не для всех типов изменений
Только для чтения - events - Список Событий аудита в формате Метаданных
Только для чтения
Возможные значение параметра source преставлены ниже:
| Значение параметра source | Описание |
| ------------------------------ |:-------------------------------|
| app | Все действия |
| copy | Копирование |
| combine | Объединение |
| import | Импорт |
| importAlfabank | Импорт из Альфа-Банка |
| importModulebank | Импорт из Модульбанка |
| importTochkabank | Импорт из Точка Банка |
| importTinkoffbank | Импорт из Тинькофф Банка |
| import1c | Импорт из 1С |
| restapi | REST API |
| remap-1.0 | JSON API 1.0 |
| remap-1.1 | JSON API 1.1 |
| remap-1.2 | JSON API 1.2 |
| posapi | POS API |
| retail | Точка продаж |
| connectors | Синхронизация с ИМ |
| evotor | Синхронизация с Эвотор |
| clearrecyclebin | Автоматическая очистка корзины |
| loginlogout | Вход или выход из моего склада |
| emailsend | Отправка сообщения |
| export | Экспорт |
| phone-1.0 | Phone API |
Возможные значение параметров eventType и entityType приведены в разделе Фильтры
Получить Контексты
Запрос всех изменений. Результат: Объект JSON, включающий в себя поля: - meta - Метаданные о контексте - context - Метаданные о сотруднике, выполнившем запрос - rows - Массив JSON сущностей, представляющих собой изменения
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
| filter | string (optional) Example: source=jsonapi Подробное описание параметра в разделе Фильтрация выборки с помощью параметра filter Атрибуты фильтрации для Контекстов аудита представлены в разделе Фильтры |
Получить Контексты
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/audit"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Изменений.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/audit/",
"type": "audit",
"mediaType": "application/json",
"size": 1,
"limit": 25,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/audit/b912e9d1-3fbe-11e7-8a7f-40d000000000",
"type": "audit",
"mediaType": "application/json"
},
"id": "b912e9d1-3fbe-11e7-8a7f-40d000000000",
"uid": "admin@1",
"source": "loginlogout",
"moment": "2017-05-23 16:50:03",
"info": "Вход в МойСклад (127.0.0.1, Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:50.0) Gecko/20100101 Firefox/50.0)"
}
]
}
Получить Контексты c фильтрацией
Параметры
| Параметр | Описание |
|---|---|
| filter | string (optional) Example: filter=entityType=customerorder фильтр по типу сущности |
Пример запроса с фильтрацией контекстов по типу "заказ покупателя" https://online.moysklad.ru/api/remap/1.2/audit?filter=entityType=customerorder
Получить Контексты c фильтрацией
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/audit?filter=entityType=customerorder"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка событий аудита.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/audit?filter=entityType=customerorder",
"type": "audit",
"mediaType": "application/json",
"size": 1,
"limit": 25,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/audit/83732f4b-792a-11e7-9464-d04800000005",
"type": "audit",
"mediaType": "application/json"
},
"id": "83732f4b-792a-11e7-9464-d04800000005",
"uid": "admin@11",
"source": "app",
"moment": "2017-08-04 18:35:15",
"objectCount": 1,
"eventType": "create",
"entityType": "customerorder",
"events": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/audit/83732f4b-792a-11e7-9464-d04800000005/events",
"type": "auditevent",
"mediaType": "application/json",
"size": 1,
"limit": 25,
"offset": 0
}
}
}
]
}
События
События аудита содержат подробную информацию о произошедших изменениях, например, изменение значения поля.
Типы Событий
События делятся на несколько типов, начиная от аудита создания сущности и заканчивая аудитом печати, и состоят из сведений о времени события и произошедших во время этого события изменениях. Различные типы событий отличаются друг от друга форматом поля diff, подробнее о котором ниже.
- Создание сущности или документа
- Обновление сущности или документа
- Удаление сущности или документа
- Помещение в корзину
- Восстановление из корзины
- Помещение в архив
- Восстановление из архива
- Публикация документов
- Отправка писем
Атрибуты сущности
- moment - время создания События
Только для чтения - uid - Логин Сотрудника
Только для чтения - supportAccess - был ли доступ произведен поддержкой от имени пользователя. Флаг отсутствует, если значение false
Только для чтения - source - Тип изменения
Только для чтения - eventType - действие События
Только для чтения - entityType - название сущности
Только для чтения - objectType - тип сущностей, с которыми связанно данное изменение. Поле присутствует только для
entityType=entitysettingsилиstatesettingsилиtemplatesettings - name - имя сущности
Только для чтения - entity - Ссылка на сущность в формате Метаданных. Не будет выводиться только для товаров, услуг, модификаций, комплектов удаленных до 20.08.2017
Только для чтения - additionalInfo - дополнительная информация о Событии. Присутствует не во всех типах событий
Только для чтения - diff - изменения, произошедшие в Событии, в специальном формате diff, описанном в разделе Формат поля diff
Только для чтения - audit - Ссылка на контекст в формате Метаданных
Только для чтения
Формат поля diff
В данном поле отображены изменения полей сущности, произошедшие в Событии.
Сведения об изменениях в полях сущностей отображаются по всем полям, включая те, к которым нет доступа через JSON API. Для полей, используемых в JSON API для сущностей и документов, название атрибута сущности будет совпадать с названием соответствующего поля, описанного в разделе для данной сущности или документа.
Ниже приведены возможные форматы поля diff для разных типов Событий.
Для событий создания сущности поле diff будет отсутствовать.
События публикации документов
- templateName - название шаблона
Только для чтения - publicationHref - ссылка на публикацию
Только для чтения
События отправки писем
- senderEmail - почта отправителя письма
Только для чтения - targetEmail - почта получателя письма
Только для чтения - subjectEmail - тема письма
Только для чтения - text - текст письма
Только для чтения
События удаления сущностей
attributeName- название атрибута сущностиТолько для чтения- oldValue - значение атрибута до удаления
Только для чтения
- oldValue - значение атрибута до удаления
События обновления сущностей, перемещения/восстановления из корзины, перемещение/восстановление из архива
attributeName- название атрибута сущностиТолько для чтения- oldValue - значение атрибута до обновления
Только для чтения - newValue - значение атрибута после обновления
Только для чтения
- oldValue - значение атрибута до обновления
Получить События по Контексту
Запрос на получение событий Контекста с указанным id. Результат: Объект JSON, включающий в себя поля: - context - Метаданные о сотруднике, выполнившем запрос. - meta Метаданные событий - rows - Массив JSON сущностей, представляющих собой события
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Контекста. |
Получить События по Контексту
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/audit/7944ef04-f831-11e5-7a69-971500188b19/events"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка событий.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/audit/c107864f-3f88-11e7-8a7f-40d000000041/events",
"type": "auditevent",
"mediaType": "application/json",
"size": 1,
"limit": 25,
"offset": 0
},
"rows": [
{
"source": "app",
"eventType": "update",
"entityType": "product",
"uid": "admin@1",
"moment": "2017-05-30 18:47:49",
"diff": {
"weighed": {
"oldValue": false,
"newValue": true
}
},
"name": "some product",
"audit": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/audit/7944ef04-f831-11e5-7a69-971500188b19",
"type": "audit",
"mediaType": "application/json"
}
},
"entity": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=7944ef04-f831-11e5-7a69-971500188b19"
}
}
}
]
}
Получить События по Сущности
Запрос на получение событий по сущности с указанным id. Результат: Объект JSON, включающий в себя поля: - context - Метаданные о сотруднике, выполнившем запрос. - meta Метаданные событий - rows - Массив JSON сущностей, представляющих собой события
Параметры
| Параметр | Описание |
|---|---|
| type | string (required) Example: product тип сущности. |
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id сущности. |
Получить События по Сущности
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/product/7944ef04-f831-11e5-7a69-971500188b19/audit"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка событий.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7944ef04-f831-11e5-7a69-971500188b19/audit",
"type": "auditevent",
"mediaType": "application/json",
"size": 1,
"limit": 25,
"offset": 0
},
"rows": [
{
"source": "app",
"eventType": "update",
"entityType": "product",
"uid": "admin@1",
"moment": "2017-05-30 18:47:49",
"diff": {
"weighed": {
"oldValue": false,
"newValue": true
}
},
"name": "some product",
"audit": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/audit/7944ef04-f831-11e5-7a69-971500188b19",
"type": "audit",
"mediaType": "application/json"
}
},
"entity": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/product/7944ef04-f831-11e5-7a69-971500188b19",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/product/metadata",
"type": "product",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#good/edit?id=7944ef04-f831-11e5-7a69-971500188b19"
}
}
}
]
}
Фильтры
В JSON API сервиса МойСклад предусмотрена возможность фильтрации Контекстов аудита с помощью url параметр filter.
Подробнее про данный параметр можно посмотреть в разделе Фильтрация выборки с помощью параметра filter
Фильтрация может осуществляться по полям, описанным ниже.
Атрибуты сущности
- moment Параметр строкового типа. В качестве значения должна быть передана строка в формате дата + время с точностью до секунд.
Допустимые операторы для фильтрации по атрибуту moment : ['>=', '<=']
Формат строки : ГГГГ-ММ-ДД ЧЧ:ММ:СС[.ммм], Часовой пояс: MSK (Московское время)
- employee
Параметр строкового типа. В качестве значения должен быть передан
hrefсущности сотрудника. В отфильтрованную выборку попадут все сущности аудита, автором изменений которых является данный пользователь.
Формат строки : href
- eventType Параметр строкового типа. В качестве значения должен быть передан тип События, по которому должны быть отфильтрованы сущности аудита. Список возможных значений параметра:
| Значение параметра eventType | Описание |
| ---------------------------- |:-----------------------|
| create | Создание сущностей |
| update | Изменение сущностей |
| delete | Удаление сущностей |
| puttorecyclebin | Помещение в корзину |
| restorefromrecyclebin | Извлечение из корзины |
| puttoarchive | Помещение в архив |
| restorefromarchive | Извлечение из архива |
| print | Печать документа |
| openpublication | Создание публикации |
| closepublication | Удаление публикации |
| sendemailfromentity | Отправка письма |
| bulkoperation | Массовая операция |
- source Параметр строкового типа. В качестве значения должен быть передан тип действия, по которому должны быть отфильтрованы сущности аудита. Список возможных значений параметра:
| Значение параметра source | Описание |
| ------------------------------ |:-------------------------------|
| copy | Копирование |
| combine | Объединение |
| import | Импорт |
| restapi | REST API |
| jsonapi | JSON API |
| posapi | POS API |
| retail | Точка продаж |
| connectors | Синхронизация с ИМ |
| evotor | Синхронизация с Эвотор |
| clearrecyclebin | Автоматическая очистка корзины |
| loginlogout | Вход или выход из моего склада |
| emailsend | Отправка сообщения |
| export | Экспорт |
| phone-1.0 | Phone API |
+ uid
Параметр строкового типа. В качестве значения должен быть передан логин сотрудника, по которому
должны быть отфильтрованы события аудита.
+ entityType
Параметр строкового типа. В качестве значения должно быть передано название сущности, по которой
должны быть отфильтрованы сущности аудита. В качестве параметра может быть передано наименование из JSON API сущности/документа(move, enter, customerorder и т.д.) либо одно из значений следующего списка:
| Значение параметра entityType | Описание |
| ------------------------------ |:------------------------------------|
| processingplanfolder | Группа тех.карт |
| amiroconnectorsettings | Настройка синхронизации (Amiro) |
| cmlconnectorsettings | Настройка синхронизации (CML) |
| ecwidconnectorsettings | Настройка синхронизации (Ecwid) |
| smartwebconnectorsettings | Настройка синхронизации (SmartWeb) |
| ymlconnectorsettings | Настройка синхронизации (YML) |
| vkconnectorsettings | Настройка синхронизации (Вконтакте) |
| yandexconnectorsettings | Настройка синхронизации (Яндекс.Маркет) |
| usersettings | Настройки пользователя |
| user | Пользователь |
| accountrole | Роль |
| entitysettings | Настройки сущностей |
| statesettings | Настройки статусов |
| templatesettings | Настройки шаблонов |
Также можно отфильтровать контексты аудита по пользовательскому справочнику. Для этого в качестве параметра entityType необходимо передать href пользовательского справочника. Пример: https://online.moysklad.ru/api/remap/1.2/entity/customentity/eaacabaf-2655-11e6-8a84-bae500000045
Получить Фильтры
Запрос всех фильтров аудита, доступных пользователю. Результат: Объект JSON, включающий в себя поля: - eventType - действия, по которым могут быть отфильтрованы сущности аудита - source - типы действий, по которым могут быть отфильтрованы сущности аудита - entityType - названия сущностей, по которым могут быть отфильтрованы сущности аудита
Получить Фильтры
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/audit/metadata/filters"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Фильтров аудита.
{
"eventtype": [
"create",
"update",
"delete",
"puttorecyclebin",
"restorefromrecyclebin",
"puttoarchive",
"restorefromarchive",
"print",
"openpublication",
"closepublication",
"sendemailfromentity"
],
"source": [
"copy",
"combine",
"import",
"restapi",
"jsonapi",
"posapi",
"retail",
"connectors",
"evotor",
"clearrecyclebin",
"loginlogout",
"emailsend"
],
"entitytype": [
"organization",
"employee",
"store",
"retailstore",
"retailshift",
"retaildemand",
"retailsalesreturn",
"retaildrawercashin",
"retaildrawercashout",
"purchaseorder",
"invoicein",
"supply",
"purchasereturn",
"facturein",
"customerorder",
"invoiceout",
"demand",
"commissionreportin",
"commissionreportout",
"salesreturn",
"factureout",
"pricelist",
"loss",
"enter",
"move",
"inventory",
"processing",
"processingplan",
"processingplanfolder",
"processingorder",
"internalorder",
"cashin",
"paymentin",
"cashout",
"paymentout",
"service",
"product",
"bundle",
"productfolder",
"variant",
"counterparty",
"currency",
"project",
"contract",
"amiroconnectorsettings",
"cmlconnectorsettings",
"ecwidconnectorsettings",
"smartwebconnectorsettings",
"ymlconnectorsettings",
"vkconnectorsettings",
"yandexconnectorsettings",
"usersettings",
"group",
"user",
"accountrole",
"specialpricediscount",
"personaldiscount",
"accumulationdiscount",
"entitysettings",
"statesettings",
"templatesettings",
"https://online.moysklad.ru/api/remap/1.2/entity/customentity/eaacabaf-2655-11e6-8a84-bae500000045"
]
}
Уведомления
Лента уведомлений
Атрибуты сущности
- meta - Метаданные объекта
- id - ID Уведомления в формате UUID
Только для чтения - accountId - ID учетной записи
Только для чтения - updated - Дата и время формирования Уведомления
Только для чтения - readed - Признак того, было ли Уведомление прочитано
- notificationType - Тип Уведомления
Только для чтения - notification - Данные Уведомления в формате Escape JSON. Формат содержимого зависит от типа Уведомления.
Только для чтения
Получить ленту Уведомлений
Запрос на получение ленты Уведомлений. Результат: Объект JSON, включающий в себя поля: - meta - Метаданные о выдаче, - context - Метаданные о сотруднике, выполнившем запрос. - rows - Массив JSON объектов, представляющих собой Уведомления.
Параметры
| Параметр | Описание |
|---|---|
| limit | number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000. |
| offset | number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей. |
Получить ленту уведомлений
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/notification"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Уведомлений.
{
"context": {
"employee": {
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/context/employee",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/employee/metadata",
"type": "employee",
"mediaType": "application/json"
}
}
},
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/notification",
"type": "notification",
"mediaType": "application/json",
"size": 1,
"limit": 1,
"offset": 0
},
"rows": [
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/notification/b67c3127-f7b2-11e8-4508-904900000043",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/notification/metadata",
"type": "notification",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#usernotification/edit?id=b67c3127-f7b2-11e8-4508-904900000043"
},
"id": "b67c3127-f7b2-11e8-4508-904900000043",
"accountId": "dbb8cfc1-cbfa-11e1-6dfb-889ffa6f49fd",
"updated": "2018-12-04 13:52:37",
"readed": false,
"notificationType": "PURPOSE_ASSIGNED",
"notification": "{ \"notificationType\" : \"PURPOSE_ASSIGNED\", \"performedBy\" : { \"name\" : \"demo@demo\", \"id\" : null }, \"purpose\" : { \"name\" : \"task1\", \"id\" : \"2687daa6-196e-11e9-382e-97f200000041\", \"date\" : \"2019-01-16 12:07:29.459\" } }"
}
]
}
Уведомление
Получить Уведомление
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Уведомления. |
Запрос на получение Уведомления с указанным id.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/entity/notification/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.
{
"meta": {
"href": "https://online.moysklad.ru/api/remap/1.2/entity/notification/b67c3127-f7b2-11e8-4508-904900000043",
"metadataHref": "https://online.moysklad.ru/api/remap/1.2/entity/notification/metadata",
"type": "notification",
"mediaType": "application/json",
"uuidHref": "https://online.moysklad.ru/app/#usernotification/edit?id=b67c3127-f7b2-11e8-4508-904900000043"
},
"id": "b67c3127-f7b2-11e8-4508-904900000043",
"accountId": "dbb8cfc1-cbfa-11e1-6dfb-889ffa6f49fd",
"updated": "2018-12-04 13:52:37",
"readed": false,
"notificationType": "PURPOSE_ASSIGNED",
"notification": "{ \"notificationType\" : \"PURPOSE_ASSIGNED\", \"performedBy\" : { \"name\" : \"demo@demo\", \"id\" : null }, \"purpose\" : { \"name\" : \"task1\", \"id\" : \"2687daa6-196e-11e9-382e-97f200000041\", \"date\" : \"2019-01-16 12:07:29.459\" } }"
}
Удалить Уведомление
Запрос на удаление Уведомления. Возможно удаление только Уведомлений текущего пользователя.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Уведомления. |
Запрос на удаление Уведомления с указанным id.
curl -X DELETE
"https://online.moysklad.ru/api/remap/1.2/entity/notification/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное удаление Уведомления.
Отметить Уведомление как прочитанное
Отметить конкретное уведомление, как прочитанное. Можно отмечать только Уведомления текущего пользователя.
Параметры
| Параметр | Описание |
|---|---|
| id | string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Уведомления. |
Отметить конкретное уведомление, как прочитанное.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/notification/read/7944ef04-f831-11e5-7a69-971500188b19"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное проставление признака "прочитано".
Отметить все Уведомления как прочитанные
Отметить все Уведомления текущего пользователя как прочитанные
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/notification/readall"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешное проставление признака "прочитано" всем непрочитанным Уведомлениям.
Настройки уведомлений
Атрибуты сущности
- groups - Подписка на уведомления по группам
groupName- Код группы уведомлений- enabled: (boolean, required) - Признак "активна" для подписки на уведомления данной группы
- channels: (array[string], required) - Массив каналов. Содержит значения из списка:
email(Email-уведомления),push(уведомления на мобильных устройствах)
Значения кода группы уведомлений.
| Код группы уведомлений | Описание |
|---|---|
customer_order |
Заказы покупателей |
invoice |
Счета покупателей |
call |
Звонки |
stock |
Складские остатки |
retail |
Розничная торговля |
task |
Задачи |
data_exchange |
Обмен данными |
Получить настройки уведомлений
Запрос настроек уведомлений текущего пользователя.
curl -X GET
"https://online.moysklad.ru/api/remap/1.2/notification/subscription"
-H "Authorization: Basic <Access-Token>"
Response 200 (application/json) Успешный запрос. JSON представление настроек уведомлений.
{
"groups" : {
"customer_order" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"invoice" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"call" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"stock" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"retail" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"task" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"data_exchange" : {
"enabled" : true,
"channels" : [ "email", "push" ]
}
}
}
Изменить настройки уведомлений
Изменение настроек уведомлений текущего пользователя.
curl -X PUT
"https://online.moysklad.ru/api/remap/1.2/notification/subscription"
-H "Authorization: Basic <Access-Token>"
-H "Content-Type: application/json"
-d '{
"groups" : {
"customer_order" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"invoice" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"call" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"stock" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"retail" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"task" : {
"enabled" : true,
"channels" : [ "email", "push" ]
},
"data_exchange" : {
"enabled" : true,
"channels" : [ "email", "push" ]
}
}
}'
Response 200 (application/json) Успешное изменение настроек уведомлений.